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Introduction 


In this lab exercise, you will be implementing a business process from the ground up for verifying 
accounts. This business process will be called SimpleAccountVerification, and will be used to process 
requests to open accounts. This business process will consist of activities such as performing credit 
checks, risk assessments, approvals, and pricing plan determination. 

The main objectives include: 

• Business flexibility 

• Better business processes 

• Easier integration 

• Reuse of assets 

• Reduction of risk 


IBM’s SOA Foundation and WebSphere Process Integration software portfolio will be used to achieve 
these goals. The focus will be on the Model, Assemble, and Deploy phases of the SOA lifecycle. 



You will use the WebSphere Business Modeler to define the business model, and then WebSphere 
Integration Developer for application assembly, deployment, and testing. You will also use the 
WebSphere Service Registry and Repository to reuse existing standard business object and service 
definitions. 

Once the business process has been implemented and deployed, you will also perform several iterative 
changes to the process to illustrate how quickly this can be accomplished. This type of business flexibility 
is one of the primary benefits of SOA. 


Important: If you encounter problems during the course of this lab, please call the attention of the class 
instructor or any of the lab assistants. 
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Scenario 

Your organization has several core business processes that need to be significantly improved. These 
processes are composed of business activities which are currently manual tasks, or implemented using 
standalone systems. These processes are currently not implemented end-to-end, which significantly limits 
business flexibility. 

In this exercise, you have been assigned to integrate a very simple business process for handling account 
applications. This is your organization’s first SOA project, so we will keep it simple and incremental. This 
will involve a very rudimentary process of determining whether a request to open an account will be 
approved or rejected. This generic example can apply to loan applications, revolving credit applications, or 
other similar scenarios. 


Lab Module Overview 


• Part 1 

• Part 2 

• Part 3 

• Part 4 

• Part 5 

• Part 6 

• Part 7 

• Part 8 

• Part 9 


Explore the Service Registry 
“Model” the Business Process 
“Assemble” the Business Process 
“Deploy” the Business Process 
IT Flexibility 
Business Rules 
Human Tasks 

Connectivity Flexibility with Mediations 
Dynamic Service Invocation 
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Part 1: Explore the Service Registry for Reuse 


WebSphere 


SQA helps businesses lower costs 

By encouraging reuse of assets 


With SO A, new services can be 
built flexibly by reusing assets 



How quickly can you make 
something new out of 
these blocks? 


Without SO A, applications have 
to be 'ripped and replaced” 



New application 
coming right up... 
right after I tear 
down the old one. 


Which makes better use of your 
existing assets; saves you money? 



Before you begin the SOA lifecycle, you will first explore the reusable assets that are 
available and stored in the WebSphere Service Registry and Repository. 

_1. Start the WSRR Server 

_a. Double-click on the Start WSRR icon on the desktop. 



A Command Prompt window will appear. 


<§> Start WSRR 

jADMU01i6I: Tool information is being logged in file 

C:\UID\pfSwps\logs\seruerl\startServer- log 
ADMU0128I: Starting tool with the wps profile 
HDMU3100I: Reading configuration for server: serverl 
ADMU3200I: Server launched. Waiting for initialization status. 
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This will start the WebSphere Service Registry and Repository (WSRR) server. The Command 
Prompt window will automatically close when the server has started. 

The next step is to briefly review the documents and concepts that have already been loaded into 
the WebSphere Service Registry and Repository (WSRR). We will only focus on the artifacts and 
metadata associated with the services to be used in an Account Verification process. However, 
feel free to explore the other contents of the registry and repository. WSRR will help promote the 
reuse of existing services and accelerate the adoption of standards. 

The following diagrams outline the concepts, logical entities, and physical documents which we will 
explore in the WebSphere Service Registry and Repository. 




WebSphere 


WebSphere Service Registry and Repository 
AccountVerification Process Service Hierarchy 


Concepts 


Logical Entities 


Physical Documents 


Credit Report Service 
(Business Activity) 


Credit Report 
Service Electronic 
(Interface) 


Basic Credit 
Report Service 
{Web Service Endpoint: 


Premium Credit 
Report Service 
(Web Semee Eindpoint: 



CreditReportService 
Elect ronicinterface.wsdl 
(WSDL Document) 


BasicCredit 
ReportService.wsdl 
{WSDL Document) 


PremiumCredit 
ReportService.wsdl 
{WSDL Document: 





The Credit Report Service will be used in an Account Verification Business Process that is similar 
to what you will be implementing in the lab exercises. There are two types of Credit Report 
Services, Basic and Premium, which are actually web services defined in WSDL documents. 
WSDL, or the Web Services Description Language is a standard specification for describing web 
services. 
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WebSphere 


WebSphere Service Registry and Repository 
AccountVerification Process Object Hierarchy 


Logical Entities 


Physical Documents 


CustomerApplication 
(Business Object) 

Businessitems.xsd 

^^-'1 (XSD 

Customer 
(Business Object) 



The CustomerApplication and Customer business objects will be used in both the 
SimpleAccountVerification process, and the more evolved AccountVerification process. The 
Customer object is actually also an attribute of the CustomerApplication object. In other words, 

the CustomerApplication object contains a Customer object. 
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WebSphere Service Registry and Repository 
AccountVerifioation Process Templates Hierarchy 


Templates 

Concepts / 
Logical Entities 

Process 

Credit Report 
Service 

Service 

Service Interface 

Credit Report Service 
Electronic Interface 

Endpoint 

Basic Credit 
Report Service 



Policy 

Premium Credit 
Report Service 



Templates were used to define the concepts and logical entities of the AccountVerification process 
stored in the WebSphere Service Registry and Repository. For example, the Service template 
was used to create the Credit Report Service concept. 

b. Double-click on the Internet Explorer icon on the desktop. There is also an Internet Explorer 
icon in the Quick Launch Bar. 


or 

c. From the Internet Explorer window, click on the WSRR Console link. You can also open the 
URL http://localhost:9083/ServiceReqistrv/ in the web browser. 



0 

Internet 

Explorer 


^ a bout :b lank -^MicmsofUntemet Explorer, 


File Edit View Favorites Tools Help 





Back 


Q t W i*l © 


D 


Search 




Address 
Link" 



about: blank 



WAS Admin Console 



WSRR Console 




BPC Exp 
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If the WebSphere Service Registry and Repository (WSRR) console page does not appear, then 
verify that the WSRR Command Prompt window started earlier has disappeared. If not, wait for 
the Command Prompt window to disappear, and then click on the WSRR Console link again. 


HXannot Jind server & Microsoft Jute Diet Exp Id rex 


File Edit View Favorites Tools Help 


& 


Back 


Q 



Address 


m http: //localhost: 9083/5erviceRegistry/ 


Links jb WAS Admin Consold^-hO WSRR Consol^^/l BFC Explorer 


Portal 



BPC 


The page cannot be displayed 


The page you are looking for is currently unavailable. The Web 
site might be experiencing technical difficultiesj or you may need 
to adjust your browser settings. 


d. When the WSRR Console page appears, click on the Service Documents -> WSDL Documents 
link on the navigation bar on the left. 


WebSphere Service Registry and Repository | Us 6 
■ Welcome 


Search 


Go 


El Unified Service Metadata 


Q Service Documents 

■ 

Load Document 

CT 

■WSDL Documents J) 


XSD Documents 

■ 

XML Documents 

■ 

Policy Documents 

m 

SCA Modules 


This will display the WSDL files that have already been loaded into the WebSphere Service 
Registry and Repository (WSRR). 
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The three WSDL files highlighted above are used in the AccountVerification process. The 
BasicCreditReportService.wsdl document contains the service, port and binding definition of a 
Basic Credit Report web service which will be invoked by the AccountVerification process. The 
PremiumCreditReportService.wsdl describes a similar credit report web service which will be 
used for premium customers. The CreditReportServiceElectronicInterface.wsdl contains the 
common interface definition for both BasicCreditReportService and the 
PremiumCreditReportService. 

Feel free to explore further by clicking on the WSDL document links. 

Click on the Unified Service Metadata -> Concepts link. 



Concepts 

T e m pIate s 


Q Service Documents 

■ 

Load Document 

■ 

WSDL Documents 

■ 

XSD Documents 

■ 

XML Documents 

■ 

Policy Documents 

m 

SCA Modules 


This will display all concepts defined in WSRR. Concepts contain the metadata information 
associated with any document or artifact. This allows us to describe an abstract business concept, 
such as a business process or business activity. 
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Concepts 


Concepts 

This is the collection of Concepts present in the registry. 
\±\ Preferences 





S e 1 e ct 

Name 

Description 

□ 

Credit ReportService 

Reports the credit Score 

□ 

Cleanse Data Service 

Cleanses data of any cc 

Total: 2 


The Credit ReportService concept highlighted above represents a business activity which is part 
of the AccountVerification process. At this level, the Credit ReportService is only an abstract 
concept, but relationships have been defined to associate this concept to actual web service 
endpoints. The endpoints are the BasicCreditReportService and the PremiumCreditReportService 
shown previously. 

f. Click on the Credit ReportService link. 



g. Click on the Custom relationships link. 
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Service 


Concepts > Credit ReportSeraice 

Details of the entity with name Credit ReportService and type Service, 


Details Impact Analysis 

Governance 


R General Properties 


Additional Properties 

Name 

Credit ReportService 


■ Custom properties 

Relationships 

Description 


t Custom relationships 1 

Reports the credit Score 

^___ 

1 a s s if i cats o n s 

Namespace 



Take note of the Governance tab. The WebSphere Service Registry and Repository also 
provides several governance capabilities which are highly recommended for any SOA project, but 
we will not apply governance in this exercise for the sake of simplicity. Governance is covered in 
more depth in other available Proof-of-Technology sessions, demos, Redbooks, etc. 

h. Click on the providedlnterface link. 



i. Click on the CreditReportServicelElectronic link. 
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CreditReportServicelElectronic is a port type which represents the set of operations provided by 
the two Credit Report web services shown earlier, BasicCreditReportService and 
PremiumCreditReportService. 

Click on the Source document link. 


Port Type 


Concepts > Credit ReportService > Custom Relationships > provided Interface > 
Credit Report Service Electronic 


Details of the CreditReportSeru ice Electronic port type. 



This will display where the relationship between the Credit Report Service interface and its WSDL 
document (CreditReportServiceElectronicInterface.wsdl) is defined. 
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WSDL Document 


Concepts > Credit ReportService > Custom Relationships > provided Interface > 
CreditReportService Electronic > CreditReportService Electronic Interface .wsdl 

Details of the CreditReportServiceElectronicInterface. wsdl WSDL document. 


Details 


C ontent 


I rn p a ct An a I y s i s 


G o v e rn a n ce 


General Properties 


Name 

C re d itR e p o rtS e rv i ce EI e ctro n i cl nte rf a ce. w s d I 


Location 


0 re d itR e p o rtS e rv i ce EI e ctro n i cl nte rf a ce. w s d I 


Description 


Captures the Credit Report Service interfat 


Namespace 

http: // P rc« ce s s e s/T o B e P ro ce s s e s/ C re d itR e f 
Owner 

UNAUTHENTICATED 


Additional Properties 

■ Port types 

■ Bindings 

■ Services 

■ Custom properties 

Relationships 

Imported schemas 

Included schemas 

Imported WSDLs 

■ Custom relationships 
Classifications 


k. Click on the Custom Relationships link. 


WSDL Document 


Concepts > Credit ReportService ^ Custom Relationships j provided Interface > 
CreditReportService Electronic > Credi iRepfl tSei^fre chronic Interface.wsdl 

Details of the CreditReportServiceElectronicInterface. wsdl WSDL document. 


Details 


C o nte nt 


I m p a ct An a ly sis 


G o v e rn a n ce 


I. Click on the availableEndpoints link. 
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This will display the two web service endpoints associated with the Credit Report Service. 



From the navigation bar, click on the Templates link. 


Search 

Go 



□ Service Documents 
Load Document 

This will display all the templates currently stored in the Service Registry. 
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Templates 


■w 


Templates 

This is the collection of Templates present in the Service Registry 
[+] Preferences 


Create new instance 

| vl III I 

S e 1 e ct 

Name 

Description 

Ve rs i o n 

□ 

Messages chema 



□ 

Servicelmpleme ntati o n 



□ 

Policy 



□ 

Application 



□ 

ServiceDefinition 



□ 

S e rv i ce I nte rf a ce 



□ 

Service 



□ 

Interface 



□ 

Process 



□ 

Business Obiect 



□ 

Endpoint 



Total: 11 


Feel free to continue browsing the Service Registry, but do not make any changes to the existing 
entities because this might affect the successful completion of the lab exercises. 

n. Close the Internet Explorer. 





Please wait for the next lecture before proceeding with the lab. 
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Part 2: “Model” the Business Process 



SOA aligns businesses for growth 

By tightly aligning IT to business processes 


With SOA, building blocks for IT 
are business services 


Without SOA, IT is organized 
by infrastructure components 


Business services are things like... 


JP “Clieclung patient records 

+ 


ra 


“Making a flight reservation 11 




i; 


Opening a bank account 


PH 



A ppl i cations Ha rdwane N etworki ng 


Which approach do you think is better 
for improving business processes? 



In this Model phase, you will assume the role of a Business Analyst. You have been 
given the responsibility of documenting an existing business process for account 
verifications. This is a simple process which involves customers submitting a request to 
open an account. The customer submits the application form with the required 
information, and then a credit report is performed to determine the applicant’s credit score. 
A credit risk assessment is then completed based on the credit score, which will result in a 
risk rating of either HIGH or LOW. A request with a high risk rating will automatically be 
rejected. A request with a low risk rating will be approved and a pricing plan will be 
determined. 
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Sim ple Account Verification 1/odel 


/: 


credit 

Report 


Customer 

Application 


Accepted 



1. Start the WebSphere Business Modeler 

a. Double-click on the Model - SimpleAccountVerification Model icon on the desktop. 



The WebSphere Business Modeler will appear, 
b. On the Quickstart Wizard, specify the following. (Refer to screenshot) 


Project Name 

SimpleAccountVerification 

Process Name 

SimpleAccountVerification 


Use the default for the Process catalog name field, and uncheck the Always show this wizard 
on startup option. 
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c. Click on Finish. 



anDix) 


d. Maximize the WebSphere Business Modeler window if needed. 

e. Close the Welcome view. 



Welcome £3 





□ 



Overview 

FimH mit u/h-at XA/oh^nhoKa 


2. Add tasks to the Business Model 

a. From the toolbar, click on the Apply 1-pane layout button. (Refer to screenshot) 
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Business Modeling - SimpleAecountVerification s h:\workspa 


File Edit View Navigate Search Project Modeling Run Window Help 




■** bimpieAccountVerification X 



This will simplify the layout and hide the advanced features and views for now. 


b. In the canvas or white-space area, right-click and then select Auto-Layout Left to Right. 


bimpleAccountVerf ication X 



v Elements 


(T) 




iN 

P 

□ 

w 


New 

► 

5how in Project Tree 

Switch to Swimlane Layout by 

► 

Show 

► 

Input and Output 

► 

Auto-Layout Left to Right 


Diagram Area 

► 

Fit to 

► 


This will compress all the default elements and make them easier to find. By default, the business 
model will initially have Process start and Process stop elements positioned in the corners of the 
canvas, but should now be visible. 

c. Select the two default process elements and press the Delete key. You will not need these 
elements for the business model you are creating. 




Tip: You can undo any incorrect actions by either pressing Ctrl-z, or selecting Edit->Undo from the 
menu bar. 


d. From the palette on the left, select the element Create local task. (Refer to the screenshot.) 
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^■Elements 



This element will represent a business task in the business process you are diagramming. Keep 
in mind that this element typically should not represent programs, applications, databases, or any 
other software component, but rather high-level activities composing a business process. 

e. Click on the canvas to drop the local task element. By default, the name of the element should be 
in edit mode. Label the element as Credit Report. 

Hint: You do not need to drag and drop. 



r 

■ 

L 


© 

Credit 

Report 


1 

■ 

J 


To rename the element, just highlight the element, wait 1-2 seconds, then click on the element 
again. The label will be in edit mode. 

f. Select three more local task elements and drop them into the canvas. Rename these new 

elements as Credit Risk Assessment, Pricing and Approval and Generate Decline. Position 
the elements similar to the screenshot. 


/ \ 

© 

Pricing and 

s - k Approval J 

© 

Credit Risk 

N Assessment J - s 

© 

Generate 
Decline J 


These four elements will represent the four tasks in our simple account verification scenario. 

These tasks will later be implemented as invocations to applications or external systems. 

g. From the palette, select the element Create simple decision and drop it in the middle of the three 
new elements. 


© 

Credit 

Report 
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▼ Elements 


© 

_ _ 

£5 


( 

S 

)1 



N 

r* 



□ 

It __ 


t Connections 




© 



Credit Risk 



\ Assessment ) 


50.0% Yes 



/ 



Pricing and 
Approval 


\ 




/ 



Generate 

Decline 


\ 


/ 


h. From the palette, click on the small arrow on the element Create start to display a submenu of 
elements. 


N 

jV j 

[oj 

fi 


i. Select the element Stop and drop to the right of both the Pricing and Approval element and the 

Generate Decline element. 




\ 


Q 

Pricing and 
Approval 


\ 


/ 



^ Start 
Q End 
Stop_^ 

j. Click on Ctrl-s to save your current progress. 

. 3. Connect tasks to define process flow 


© 

Generate 

Decline 



a. From the palette, click the Connections button. 



This will allow you to start defining the flow through the different tasks to represent the business 
process flow. 

b. Click on the left border of the canvas, and then click on the Credit Report task. 
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This connection indicates that the Credit Report task will be invoked first and will be passed some 
String or text information as a parameter. 

c. Complete the following connections: 


© 

Credit 

Report 



© 

Credit Risk 


\ Assessment / 



© ^ 
Pricing and v., 

^ Approval 



© c 

Generate 



38 


d. 


From the palette, click on the Select button to switch out of connection mode. 



e. Right-click on an empty space in the canvas. From the popup menu, select Auto-Layout Lett to 
Right. 


New 

► 

5how in Project Tree 

Switch to Swimlane Layout by 

► ' 

Show 

► 

Input and Output 

► 

^^Auto-Layout Left to Right 

Diagram Area 

► . 

Fit to 

► 


The wiring of all the business tasks to define the process flow is now complete. You will now 
configure the business item that will be used by the business tasks. 

f. Click on Ctrl-s to save your current progress. 
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g. Close the SimpleAccountVerification Model editor. 


^ J SimpleAccountVerificatfcn M 



h. From the toolbar, click on the Apply 4-pane layout button 


t Business Modeling | SimpleAccountVerification - h:\workspac 


File Edit View Navigate search Project Modeling Run Window Help 

(Bta n j - j # j 


jjfr* *5smpI e A cco u nt V e rii c a t i on X 


This layout will expose more views and information about the business model. 

i. From the Project Tree view, expand the Project list and select SimpleAccountVerification -> 
Business service objects. 


Project Tree X 


- SimpleAccountVerification 
+ Cj^i Business items 
+ Processes 
i-£ Resources 
Q§] Organizations 
C|, Classifiers 
g] Reports 
Queries 

Business services 





Business service objects 


^ Predefined resources 

Qg] Predefined organizations 
CM. Predefined classifiers 




The next step is to reuse existing business object definitions to promote standards. In the 
SimpleAccountVerification business process, the customer information required by the 
verification process will be stored in a standard business object called CustomerApplication. 
The CustomerApplication object definition will be retrieved from the WebSphere Service Registry 
and Repository server and stored in the Business service objects folder highlighted above. 

j. From the Project Tree, right-click on the Business service objects folder. From the popup 
menu, select Business Service Search. 
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New 


► 




Import... 

Export... 


Rename 
Search... 


Business service searchT/^ 


Version ► 

Static Analysis ► 

Publish... 


k. Ensure that wsrrstew is selected as the WebSphere Service Registry and Repository server, 
then click Next. 



The selection wsrrstew is an alias for the WebSphere Service Registry and Repository server you 
had previously started. The Command Prompt window which appeared when you started the 
server should have disappeared by now to indicate that the server is now running. If not, wait for 
the window to disappear before proceeding to the next step. 

I. Specify Businessitems as the Search criteria (case-sensitive). Select the Business service 
objects option, and then click on Search. This will return the file Businessitems.xsd. 
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Businessitems.xsd is a XML Schema Definition (XSD) file containing the definition of the 
CustomerApplication business object. XSD is a standard specification for defining data structures 
using XML. 


m. 


Select the All button 

Finish. 



to move Businessitems.xsd to the Files to import column. Click on 


Files found by the search: Files to import: 



This will import the CustomerApplication object into the Business services objects folder in the 
Project Tree view. It will also import another object called Customer because it is part of the 

CustomerApplication object. 
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n. From the Import status information window, click on OK. 



o. From the Project Tree view, expand the Business service objects folder. Ensure that both the 
Customer and CustomerApplication business objects exist. 


Project Tree X 


+ 


- & 


rh 


rh 


5impleAccountVerification 
Cfy Business items 
Processes 
Resources 
Cg Organizations 
Classifiers 
=| Reports 
Queries 
Q { Business services 

*3 


Business service objects 


& 


- Businessitems 



o Customer 
r) CustomerApplication 
^ Predefined resources 
Cg] Predefined organizations 
CM. Predefined classifiers 



p. From the Project Tree view, double-click on CustomerApplication. This will open the 
CustomerApplication business object view. 
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So SimpleAccountVerification 


customer Application X 


Customer App I i cat i on 


Parent template 


None 


Business service object definition attributes 

Attributes are properties or significant features. Inherited attributes can only be edite 


Name 

Type 

applicationID 

E 

String 

applicationDate 


Date 

pricing 


String 

requestedlirnit 


Float 

— customer 


Customer 

customer ID 


String 

companyName 


String 

customer Address 


String 

customerCity 


String 

customerStateProvince 


String 

customer Country 


String 

custornerPostalCode 


String 

customerT axID 


String 

creditScore 

S 

Integer 

creditReportRequired 


Boolean 

applicationDecision 


Boolean 

creditRiskAssessment 


String 


This is the data structure of the CustomerApplication business object. As you can see, it also 
contains a nested Customer business object. 


_q. Close the CustomerApplication business object view. 


£o SimpleAccountVerification 


x 


Customer Appl ication 




Parent template 


None 


r. From the Project Tree view, double-click on SimpleAccountVerification -> Processes -> 
SimpleAccountVerification to open the model editor. 


Project Tree X 


+ - |S> 1=1 □ 


- SimpleAccountVerification 
Business items 

- t g? Processes _ _ 

SimpleAccountVerification 
LgP.e sources 
Organizations 
LI Classifiers 
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_s. Drag and drop the business item CustomerApplication on the connection between the left border 
of the canvas and the element Credit Report. 

Hint: A dotted box appears when the object is ready to be dropped on the connection. 

L[§a Organizations 
Classifiers 
Reports 
Queries 

I jj Business services 

Business service objects 


- 


- 


§]] Businessitems 


,i" Customer 


$ 

\±\ 

+ 



CustomerApplication 


Predefined resources 
Predefined organizations 
Predefined classifiers 





n 




r°l String 


© 

Credit 

Report 


This drag and drop action sets up the business item CustomerApplication as the input to the 
activity Credit Report. The connection should now look similar to this: 




Credit 

Report 


CustomerApplicatiorT^ 


\ 




t. Drag and drop the CustomerApplication business item on the rest of the connections. 


© 

Credit 

Report 


Q CustomerAfjp lication 

Credit Risk 
Assessment 


50.07c 




© CustomerApplication 


Screenshot continued... 
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r°l CustomerApplication qq 


pa 

l 


Pricing and 
Approval 


Q CustomerApplication GU 

r Generate 

Decline 


Q CustomerApp lication 


V 

\ 


Q CustomerApp lication 


u. Right-click on the Yes connection between the Decision activity and the Pricing and Approval 
activity. 



Q CustomerApplication 

uecision 


50.#% Yes Q Cus tomer Application fjg 

Pricing and 
Approval 


ijj CustomerApp lication 


50.0% No 


f°l CustomerApplication GQ 
11 i Generate 


Decline 


CustomerApp lication 


v. From the popup menu, select Associate Data. From the Type Selection window, select 

CustomerApplication, then click on OK. 
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w. Right-click on the No connection. From the popup menu, select Associate Data. 




r°~l Customer Application 

Decision 


50.0 % Yes Q Cus tomer Application q 


Pricing and 
Approval 



Q CustomerAm lication 





.0% No 


Customer Ajapft^tion LJ 

Generate 
Decline 


Q CustomerAm lication 


x. Select CustomerApplication, then click on OK. 

y. Click on Ctrl-s to save your current progress. 

z. From the menu bar, select Modeling->Mode->lntermediate. 


ccougfVerili^atiog^^Wo^kspaces^OA.Mode^- IBM WebSphere Business Modeler, Ad vane 

Project 

Run Window Help 


© J 

fl| Create ► 


v t 100 % ▼ Gt Ct N 


@ Mode ► 

V lei Basic 

Alt+Ctrl+B 

•J +r 

Quickstart wizard 

Intermediate 

Alt+Ctrl+I 1 




Advanced 

Alt+Ctrl+A 


This mode will provide more advanced tooling capabilities. Specifically, this will allow us to 
provide more sophisticated logic to the Decision element. This will also now display more 
information on the business model diagram. 


4. Define the branch logic for the Decision element 

a. Select the Decision element. 








Annotation 

fij ”L 

1 1 1 

5 O 

E £ 




b. On the Properties area at the bottom section of the screen, click on the Attributes - Decision 
tab, and then the Output branches tab. 
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fe Attributes - Decision t%£i 


Simulation Control Panel Errors (Filter matched 2 of 2 items) 


General 


Inputs 




Outputs Input branches 



Output branches 



Output branches 


c. Select the row for the Yes output branch. 


Name 


l^lo - 


Contents 


Output 


Output:2 


d. Double-click on the Attributes - Decision view titlebar to maximize the view. 



Hint: You can maximize any view by double-clicking on its titlebar. Double-clicking again on the 
titlebar will restore the view to its original size. 

e. On the lower-right corner of the view, click on Edit. Scroll down if necessary. 


Expression 



The Expression Builder window will appear. 

f. In the Expression Composer section, expand the First term details tree list, and then select 
creditRiskAssessment. Ensure that you are selecting creditRiskAssessment from the Input 
parent branch, and not the Input Criterion branch. 
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/ ; 

Expression Composer 

/ 

First term: 

Modeling artifact 


First term details: 


- (g? Processes 


- 5impleAccountVerification 

> Decision 

- D Input 



applicationID 



applicationDate 



]□ pricing 



]□ requestedLirmit 

| E 

B- 

f°l customer 



]□ credit5core 



creditReportRequired 



EL aoolicationDecision 


d 

creditRiskAssessment 

+ £ Input Criterion 


g. Make the following selections: 



i. Ensure that the Expression text contains the following expression, then click on OK. 

Expression text: 

'Processes.SimpleAccountVerification.Decision.Input.creditRiskAssessment' is equal to "LOW" 

This will also automatically create an inverse expression for the No output branch. 
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j. Double-click on the Attributes - Decision view titlebar to restore the view to its original size. 



attributes - Decision w 


General 

Output branches 




usiness Measures Errors (Filter matched 0 of 0 items) 


Outputs 



Input branches Output branches 



k. Press Ctrl-s or click on the Save button on the toolbar. 



I. Click on the Errors tab and ensure that there are no errors listed. 


The business model is now complete. 

Important Note: At this point, for the sake of simplicity, we will just use the default names for the 
operations of the tasks, as well as the names of the input and output variable. Most of the 
operation names will default to InputCriterion. Also by default, input variables will typically be 
named inputl, and output variables will be named outputl. 


5. Export the business model 

The business model will now be exported to the file system as a BPEL version of the model. In 
the next part of this lab, this BPEL model will be imported into the WebSphere Integration 
Developer and refined. 

Hint: If the business model was not completed successfully, or was not exported successfully, 
then you can still proceed to the next part of this lab. A solution version of the model is available if 
needed. 


a. From the menu bar, select File -> Export. 

b. From the Export window, select WebSphere Business Modeler Export, then click on Next. 


Select an export destination: 


Datapool 

£ > Deployable features 
, J Deployable plug-ins and fragments 

i_i File system 

/'JAR file 


/ Javadoc 
^ 1,1 Profiling filter 
y | Symptom database file 
jSi Team Project Set 


! WebSphere Business Modeler Export^ 
Zip file 


c. From the next WebSphere Business Modeler Export window, select WebSphere Process 
Server, then click on Next. 
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'^Delimited text (.csv f .txt) 

■■•^WebSphere Business Modeler XML (.xml) 


■ rWweoSphere Process Server 


Websphere 


Business Monitor Development Toolkit (.mm) 


d. From the next WebSphere Business Modeler Export window, specify the following: 


Target directory 

c:\lab 

Project 

SimpleAccountVerification 

Project selection scope 

Export entire project 


Target directory 

^\\\ab 


Project 

SimpleAccountVerificatior^ 


S) Ewpor t entire project ) 

O Export specific elements 



e. Click on Finish. 


The business model has now been exported into the file system and is ready for import into the 
WebSphere Integration Developer. 

f. From the Export finished window, click on OK. 

g. From the main menu, select File -> Exit to close the WebSphere Business Modeler. 


The “Model” phase of our SOA approach to implementing this simple 
business process is now complete. 



Please wait for the next lecture before proceeding with the lab. 
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Part 3: “Assemble” the Business Process 



SOA helps business 




osts 


By making integration easier 


With SOA, integration is done 
“loosely” with modular pieces 


Without SOA, integration is done 
with “hardwiring” 


Easier 

Integration 



How easy would it be to add or 
subtract a piece to this structure? 



How would you reconfigure 
this f or another user? 


Which method do you think is easier, faster? 



In the Assemble and Deploy phases, you will now switch roles. You will now be an 
Integration Developer who is responsible for assembling the different service 
components to compose the business process. The next steps will illustrate how the 
loose-coupling and building-block approach can be applied to integration development. 
Through loose-coupling, the different applications and systems required by the business 
process can be modularized and treated as building blocks. This will make integration at 
the larger, global, and enterprise-wide scale significantly easier. 

_1. Import the business model into the WebSphere Integration Developer 

_a. Double-click on the WID - SimpleAccountVerification icon on the desktop. 


WID - 

SimpleAccount 

Verification 


The WebSphere Integration Developer Welcome view appears by default. 
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^ Business Integration ^ h:\workspaces\SOA JBM 


File Edit Navigate Search Project Run Window Help 


u 


4* Welcome «I6 


WebSphere. 


Integration Developer 


b. 


Maximize the WebSphere Integration Developer window if needed. 



c. Close the Welcome view or click on the Workbench icon on the Welcome view. 



The Business Integration perspective now appears, 
d. Right-click inside the Business Integration view. From the popup menu, select New->Module. 


Business Integration X 



New 


Open 


Copy 

Paste 

Pul.—.i i.—. 




Project... 


Mediation Module 
Module^ 



Library 



e. In the New Module window, specify SimpleAccountVerification for the Module Name. Accept 
the other defaults and click on Finish. 


J 1 - New Module 


Module 

Create a new business integration module, A module is 
version management organizing resources; and deploy 


Module Nam 

Module Location 
1^ Lise default; 


^JsimpleAccountVerification"^ 


The new module will now appear in the Business Integration view. 
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fe= Business Integration £3 

= □ 

a & e % - 

SimpleAccountVerification 
Assembly Diagram 
^ Dependencies 
+ & Business Logic 
(= Data Types 
- Interfaces 
+ Mapping 

Y Events 



f. From the menu bar, select File->lmport. 

g. From the Import window, select File System, then click on Next. 


-t* Import 


Select 

The following wizards are available. 


Select an import source: 

% External Plug-ins and Fragments 
ij^File syste m 
| FTP 

h. In the From directory field, type c:\lab, then press the Tab key. Place a checkmark beside the 
lab folder in the list. 


^Import 


File system 

Please specify folder 



Hint : The business model defined in the previous part of this lab was exported to this directory. If 
this directory does not exist, or if the business model was not completed or exported successfully, 
then you can use the solution version of the business model at c:\PoTFiles\lab instead of c:\lab. 
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i. Click on the Browse button to the right of the Into folder field. Select 

SimpleAccountVerification from the list, then click on OK.. It should then appear in the Into 
folder field. 


Filter Types... Select All Deselect All 


Into folder ^Simple AccountVerif icatiorT^- 

I Browse... j 


j. Click on Finish. This will import the business model created earlier using the WebSphere 
Business Modeler. 


k. If a progress indicator appears, wait until it is complete. Building workspace: (27%) 


. 2. Assemble the business process 

a. By default, the Assembly Diagram: SimpleAccountVerification editor should already be open. 

If not, then double-click on SimpleAccountVerification -> Assembly Diagram from the 
Business Integration view to open the Assembly Diagram editor. 
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fe= Business Integration £3 

= □ 


a & b % ▼ 


- SimpleAccountVerification 
Assembly Diagram 
Dependencies 




Business Logic 
1 — Data Types 
1 Interfaces 
- Mapping 
? Events 


The Assembly Diagram editor appears showing the different components of the business process. 
In IBM’s SOA approach, the implementation of the tasks in the process is not tightly-coupled. For 
example, the implementation of the Credit Report task invoked by the SimpleAccountVerification 
process is not defined inside the process. It is kept separate and loosely-coupled, and is defined 
externally using the Assembly Diagram editor. This added level of abstraction provides the 
flexibility needed to quickly change implementations. This will be illustrated later in the lab. 

The Assembly Diagram editor is where the building-block approach is applied. This editor allows 
you to integrate or assemble different components to compose a business process. Components 
can be web services, human tasks, BPEL processes, business rules, EJBs, Java programs, 
message-based (JMS) applications, or other legacy systems accessed using adapters or ESBs. 
These assemblies can integrate applications spanning different technologies, runtime platforms 
and programming languages. This is where we perform the “assemble” phase of the SOA cycle. 



b. Double-click on the Assembly Diagram editor tab to maximize the view. 


Assembly Diagram: simpleAccountVerif ication 



Double-clicking on the tab again will restore the view back to its original size. For now, let's keep 
the view maximized so we can have more screen space to work with. 

c. From the Assembly Diagram editor, double-click on the SimpleAccountVerification process. 
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% Assembly Diagram: bimpleAccountVerification 




& 


(i.j There are 6 new elements that have bee 



A 


0-0 




The SimpleAccountVerification process editor appears, 
d. Review the SimpleAccountVerification process. 



T 


This is the BPEL version of the business model defined using the WebSphere Business Modeler. 
BPEL will be explained later on. Because this was exported from the WebSphere Business 
Modeler, it is already complete and does not require further development. 


e. 


Close the SimpleAccountVerification process editor. 


bimpleAccountVerificatior X 



The Assembly Diagram editor will reappear. At this point, the tasks of the business process have 
been defined, as well as the flow through these tasks. However, the tasks have not yet been 
implemented. The next step is to implement the four tasks of our simple process. 
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Credit Report 


Credit Risk Assessment 


Pricing and Approval 


^ Generate Decline 


These tasks will be initially implemented using Java code because the applications and back-end 
systems which need to be invoked by this process are still not yet accessible either through web 
services, messaging, adapters, or an enterprise service bus. That is still under development by 
other departments in your organization, or by business partners. For now, you will implement 
code stubs or placeholders for the actual applications and back-end systems until these become 
accessible. 






3. Implement the tasks of the business process 


*(& cl CreditReport_859917159 

a. Double-click on the Credit Report component. 

b. From the Open confirmation window, click on Yes. 



c. From the Implement As window, select Java from the list, then click on OK. 



d. From the Generate Implementation window, accept the default selection, then click on OK. 
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-t* J^ener.ateJmDlemeiitatjoji. 


Select the package where the Java implementation will be generated: 


(default package) 


a_ 

businessitems 

fs- businessserviceobjects 
ffl processes 

a processes. simpleaccountverif ication 


The Java editor appears for the implementation of the CreditReport component. 



* Assembly Diagram: SimpleAccountVerif ication 


backage sca.comp □ nen t. java. imp 1 ; 



LreditReport J359917159Impl, java 



I* import commonj . sdo . DataOb j act; Q 


^public class CreditRepoi:t_859917159Impl { 

^7 / * * 


e. Scroll down to the bottom of the Java code. Select the highlighted text below and delete. 


public DataObject InputCuiteuion(DataObject input) { 



//TODO Needs 

to be implemented. 

return null; 

.. 


> . Delete highlighted 


f. Type credrep in the line of code as shown below. Press Ctrl-Spacebar. 


v' 


publ ic D ataObjact InputCuiterion(DataObject input) { 

%££$££&) . v 

} Press Ctrl-Spacebar 


The Ctrl-Spacebar key combination activates a special feature called Code-Assist. This will add 
the required code snippet for you. 
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pub lic, DataObject InputCr iter ion (DataObject input) { _ 

/11 

* CODE STUB 

* Placeholder for production code later 

* Code only for initial development and testing 

V 

int creditScore = 501; 

DataObject customer = input. getDataObject ( "customer rr ) ; 
if (customer.getString( "customerID") .equalsIgnoreCase( "123 ") ) 
creditScore = 449; 

System.out.printIn (">>>>>>>>>>>>>>>>>>>>>"); 

System.out.printIn( ">>>>> Credit Score = " + creditScore); 
input.setlnt ("creditScore", creditScore); 
return input; 


This code logic will return a credit score of 449 if the Customer ID submitted in the request is 
“123”, otherwise a credit score of 501 will be returned. A credit score below 500 will be considered 
high-risk, and a score above 500 will be considered low-risk. In other words, a request with a 
Customer ID of “123” will be rejected, and any other Customer ID will be approved. 


g. Press Ctrl-s to save the Java code, then close the Java editor. 

h. From the Assembly Diagram editor, double-click on the Credit Risk Assessment component. 

-C j^ Sb CreditRiskAs5essment_2053491712 

i. From the Open confirmation window, click on Yes. 

j. From the Implement As window, select Java from the list, then click on OK. 

k. From the Generate Implementation window, accept the default selection, then click on OK. 

l. In the Java editor, scroll down and perform the following code modifications: 


public DataObject InputCriterion(DataObject input) { 



//TODO Needs 

to be implemented. 

return null; 

. . 


> . Delete highlighted 


Type credrisk. 


T71 


public DataObject 


c 


c L" e dr i s k 

■VvVvVvVvVvVvVvV-. 


InputCriterion(DataObject input) 

^ Press Ctrl-Spacebar 


{ 
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This code will assign a risk assessment of “LOW” if the credit score is above 500. Conversely, a 
credit score below 500 will be assigned a risk assessment of “HIGH”. 


m. 

n. 


Press Ctrl-s to save the Java code, then close the Java editor. 

From the Assembly Diagram editor, double-click on the Pricing and Approval component. 




a 


Pricingand Appro val_l 3510682 


o. From the Open confirmation window, click on Yes. 

p. From the Implement As window, select Java from the list, then click on OK. 

q. From the Generate Implementation window, accept the default selection, then click on OK. 

r. In the Java editor, scroll down and perform the following code modifications: 


public DataObject InputCriterion(DataObject input) { 



//TODO Needs 

to be imp lenient ed. 

return null; 

. . 


> . Delete highlighted 


Type pricapp. 




pub lic D ataObject InputCriterion(DataObject input) { 

. 

> - ' Ctrl-Spacebar 
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public 

DataObject InputC 

riterion(DataObject input) { 


/pT ** 


\ 


* 

CODE STUB 




* 

P1ace ho 1de r for 

production code later 



* 

Code only for initial development and testing 



V 





System.out.println( " 

>>>>> Request is approved!."); 


return input; 

J 

} 






s. Press Ctrl-s to save the Java code, then close the Java editor. 

t. From the Assembly Diagram editor, double-click on the Generate Decline component. 

■m P GenerateDedine_01457417057 


u. From the Open confirmation window, click on Yes. 

v. From the Implement As window, select Java from the list, then click on OK. 

w. From the Generate Implementation window, accept the default selection, then click on OK. 

x. In the Java editor, scroll down and perform the following code modifications: 


public DataObject InputCriterion(DataObject input) { 



//TODO Needs 

to be implemented. 

return null; 

.. 


> . Delete highlighted 


Type gendec. 


V 


publ ic Pat a Object 

C gendec\ 

.■TvVvVvVvVvV'. / 


f * J 


* * * 


InputCriterion(DataObject 

Ctrl-Spacebar 


input) 


{ 


public DataObject InputCriterion(DataObject input) { 


7 ** 

■ft 


CODE STUB 


* Placeholder for production code later 

* Code only for initial development and testing 

V 


System.out.printIn( ">>>>> Request is denied!."); 
return input; 


y. Press Ctrl-s to save the Java code, then close the Java editor. 

z. From the Assembly Diagram editor, press Ctrl-s to save your work. Do not close the Assembly 
Diagram editor because this will be needed for later steps. 
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The “Assemble” phase of our SOA approach to implementing this simple 
business process is now complete. 

Proceed to the next part. 


Simple Service Oriented Architecture Lab 


Page 46 of 171 



© Copyright IBM Corporation 2007. All rights reserved 


Part 4: “Deploy” the Business Process 


4. Deploy and test the business process 


a. Double-click on the Assembly Diagram editor tab to restore the view to its original size. 


i Assembly Diagram: simpleAccountVerification X 


b. In the bottom section, click on the Problems tab. Ensure that there are no errors listed. 


Propertiel 




Problems X 


Servers 


0 errors., 0 warnings., u Infos 



Description 

Resource 

In Folder 










c. Click on the Servers tab. Verify that the WebSphere Process Server v6.0 test server is already 
started. 


^WebSphere Process Server v6,0 


localhost 


Started 


d. 


This test server built into the WebSphere Integration Developer is a full instance of the 

WebSphere Process Server. 

Right-click on the WebSphere Process Server v6.0 test server. From the popup menu, select 

Add and remove projects. 


< + * 


!-i 


CE 


Properties Problems 


71 


^Servers X 


Com 


Server 


Monitoring 


Add and remove projects... 


^WebSphere Process Server v6.0 




Run universal test client 
Restart universal test client 
Run administrative console 

Reconnect debug process 

[ J Create tables and data sources 

Import server configuration from server 
Export server configuration to server 



Launch 
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e. From the Add and Remove Projects window, click on Add. 


Add and Remove Projects 


Add and Remove Projects 

Modify the projects that are configured on the server 


Move projects to the right to configure them on the server 

Available projects: Configured projects: 



faS Simple AccountVerificationA 




J 


f. Click on Finish. This will add the business process to the test server configuration. 

g. A progress indicator will appear in the lower-right corner of the WebSphere Integration Developer 
window. Wait for this indicator to disappear before proceeding to the next step. 


Add and Remove Projects 



h. Focus will automatically switch to the Console view. Verify that a message appears in the 
Console view indicating that the SimpleAccountVerificationApp process has started. Scroll 
right as needed. 


Console X 


.0 [WebSphere v6.0 Server] WebSphere Process Server v6.0 (WebSphere v6,0) 

com. ibm. us . al .bootstrap . UASBootstrap appStart (DeployedApplication) CU 
S C A_S TARTING_AP P_MOD UL E 
S C A_S TAPTED_AP P_MOD UL E 

USVP0207I: Preparing to start EJB jar: SimpleAccountVerificationEJB 
WSVR0037I: Starting EJB jar: SimpleAccountVerificationEJB.jar 
J2CA0306I: Applic ation SimpleAccountVerificationAppflSimpl eAccou ntVe 
USVPQ2 2 ll ^App lication started: SimpleAccount.Ve~ificationApp S 


i. Switch to the Servers view and right-click on WebSphere Process Server v6.0. From the popup 

menu, select Launch -> Business Process Choreographer Explorer. 
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The Business Process Choreographer Explorer appears. This is a built-in web application that 
provides a way to manage business processes, as well as work items associated with human 
tasks in the process. 

j. Click on the My Process Templates link to display a list of processes which can be started. 


t Assembly Diagram: SimpleAccountVerification 


■■ Business Process choreographer Explorer 


Welcome: (English) 


Help 


-] Process Templates 


y P ro ce s s Te m pi at e T 


1 


My Tasks 



k. Place a checkmark beside the SimpleAccountVerification process template, then click on Start 
Instance. 


Available Actions 


Start Instance ^ Instances 


View Structure 


Refresh 


V 


Process Template Name 
© SimpIeAccountVerification 0268109345 

Items found: 1 Items selected: 1 


Valid From 0 
2/10/07 8:12:0 


-=: < 


This will start the SimpleAccountVerification business process, and display the default input page. 
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I. From the default input page, click on the Expand button. 


S u b m it 


Process Template Name 
Operation 

Process Name 
Process Input Message 


S i m p I eAcco u ntV e rif i cati o n_0 266109S45 
InputCriterion 



m. For the customerlD field, type 123, accept the defaults for the other fields, then click on Submit. 

Submit | 


Input 


applicationID 

applicationDate 

pricing 

requested Limit 
customer 




customerlD ^ 

123 


companyName 




A Customer ID of “123” will result in a low credit score and a denied request. Any other Customer 
ID value will result in an approved request. 

n. After a few seconds, the SimpleAccountVerification process will generate messages to the 
Console view indicating that the Request is denied. 
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Console X 


.0 [WebSphere v6.0 Server] WebSphere Process Server v6.0 (WebSphere v6.0) 


j 


59 EST] 
59 EST] 
12 EST] 
12 EST] 
81 EST] 


□□□□□□89 SystemOut 
□ □□□□□89 SystemOut 
OOOOOOaS SystemOut 
OOOOOOaS SystemOut 
□□□□□□8a SystemOut 



O 

O >>>>> Credit Score = AA9 

O >>>>> Credit risk = HIGH 
O >>>>> Request is denied!. 


This indicates that the business process is functioning properly. You can also try other input 
values for the customerlD to see the request approved. 


customerlD 





O 


O >>>>> Credit Score = 501 

O »»Y Credit risk = LOW 
O >>>>;\Request is approve 



o. When you’re done testing the business process, switch to the Servers view. 


p. Right-click on the WebSphere Process Server v6.0 test server. From the popup menu, select 

Add and remove projects. 


Properties Problems 



Add and remove projects. .7^^^ 


Server 


.■ V 

WebSphere Process Server v6.0 


Run universal test client 
Restart universal test client 
Run administrative console 

Reconnect debug process 


Hosl 


loca 


q. From the Add and Remove Projects window, click on Remove All. 

r. Click on Finish. 

s. Close the Business Process Choreographer Explorer. 


>- ) Assembly Diagram: SimpleAccountVerification 

y) Business Process Choreographer Explor^ 



Welcome: (English) 

Help 
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The “Deploy” phase of our SOA approach to implementing this simple 
business process is now complete. 



Please wait for the next lecture before proceeding with the lab. 


Simple Service Oriented Architecture Lab 


Page 52 of 171 






© Copyright IBM Corporation 2007. All rights reserved 


Part 5: Handling Change with IT Flexibility 



SOA improves businesses’ ability to meet market needs 

By providing a more flexible infrastructure 


With SOA, II is flexible 
and responsive to 
business needs 

Business 
Flexibility 


Imagine if your business 
could do that 



Without SOA, IT can’t easily keep up 
with fast changing requirements of 
customers, partners, and competition. 



Do you need superhuman strength to 
make changes to your business? 


if innovation is defined as the process of making changes to do 
something new, which method would be best for innovation? 



To illustrate the IT flexibility needed for business flexibility, you will change the 
implementation of one of the tasks without major effort. By employing the building block 
approach and loose-coupling, switching to a different application or system becomes 
easier and quicker, even though the new system may involve a different technology, 
programming language, communication mechanism, and runtime environment. This will 
allow business processes to be more responsive to changes in their business 
environment. These changes might involve having to quickly adapt to customer demands, 
exploit new market opportunities, or react to competitive threats. SOA provides this type 
of business agility. 

In our simple scenario, let’s assume that the Credit Report task now needs to invoke an 
existing system exposed as a web service. You will now change the implementation type 
of this task from a Java program to a web service invocation. The web service is really 
just an example in this exercise. Instead of a web service, you can just as easily switch 
the Credit Report task to a human task, business rule, business process, etc. 
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1. Import the Credit Report Web Service 

a. From the main menu, select File -> Import. 

b. From the Import window, select EAR file, then click on Next. 



The Credit Report web service will need to be imported as an Enterprise Archive file (EAR). The 
EAR file contains all the code and artifacts needed to run the web service. In a production 
environment, you typically only need the web service description file, or the WSDL file, to invoke 
the web service because the web service code should be running on a separate remote server. 
However, for this lab, we will deploy and run the web service in the test server of this development 
environment. 

c. From the Import window, click on the Browse. 
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d. From the Open window, using the drop-down list, navigate to the directory C:\PoTFiles. 


Open 


Look in: 



My Recent 
Documents 



Desktop 


& PoT Files 


My Recent Documents 
Desktop 
0 My Documents 
^ My Computer 
-.%> 3* Floppy (A:) 
Local Disk fC:l 


PoT Files 


CD Drive (D:] 
i^j Shared Documents 





e & 



e. From the Open window, select the LabCreditReportService.ear file, then click on Open. 



This is the EAR file containing the Credit Report web service, 
f. Click on Finish. 
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This will load all the code and artifacts of the CreditReport web service into the current workspace 
of the WebSphere Integration Developer. 

g. From the Confirm Perspective Switch window, click on Yes. 



This will switch to the J2EE perspective to allow us to view the Credit Report web service. You 
were previously in the Business integration perspective, which is better-suited for your role as an 
Integration Developer. We will return to the Business Integration perspective shortly. 

h. Expand the tree view to select Dynamic Web Projects -> LabCreditReportWebService -> 
WebContent -> wsdl -> lmport1_CreditReportHttpPort.wsdl. 
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r -^ 

" - Project Explorer X 


S" 

Enterprise App 

lications 


ta b % 


Qjl Connector Projects 
EJB Projects 

L ^ Dynamic Web Projects 
- £7 LabCreditReportWeb5ervice 
Qj Web 5ite Navigation 
Web Diagram 

i a _ __ 

+ (fig Deployment Descriptor: LabCreditReportWeb5ervice 
+ 0 Java Resources 
- 123 1 WebContent 
+ & META-INF 
+ & theme 
+ & WEB-INF 
wsdl 

+ 0 ? businessserviceobjects 
+ & processes _ 

(i) Import l_CreditReportHttpPort. wsdl 
CD Other Project 
C jp Web Services 
i j Databases 
Cq Database Servers 



This is the description file for the Credit Report web service which will be invoked by the 

SimpleAccountVerification process. 


i. Right-click on the lmport1_CreditReportHttpPort.wsdl file. From the popup menu, select Copy. 


i ■ i >.i i 1 .-111 1 —* 


+ WEB-INF 


— [■■—j? wsdl 

New 


► 

+ l23> businessserviceobjects 
+ Qf*? processes 

Open 



Import 1 j.reditReportHttpPort. wsdl |j 

Open With 


► 

- Lll Other Projects 

+ P 7 SimpleAccountVerification 

[U Copy 



+ L Web Services 

If Paste 



El- Cq Databases 
+ Cn Database Servers 

H Delete 




■ 

J- 


From the tree view, expand the Other Projects folder, and right-click on the 

SimpleAccountVerification folder. 






(i ) Import 1 _CreditReportHttpPort. wsdl 


- (_J Other Projects 


+ £7 


SimpleAccountVerification 


+ Cj 1 Web Services 
+ Lq Databases 
+ Lq Database Servers 



This will copy the WSDL file for the CreditReport web service into the 
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SimpleAccountVerification project. This will allow us to visually connect this web service to the 
SimpleAccountVerification process in the Assembly Diagram editor. In a realistic development 
project, you probably won’t need to copy the WSDL file because this will typically be loaded from 
an external registry, such as the WebSphere Service Registry and Repository or a UDDI registry. 

k. From the main menu, select Window -> Close Perspective. 



File Edit Navigate Search Project Run 

Window 

J nf J ^ - o 

New Window 

r. x 

Open Perspective ► 

Show View ► 

+ ( □ Enterprise Applications 
+ Application Client Projects 

+ Qj. Connector Projects 
+ EJB Projects 

- Dynamic Web Projects ^ 

- £7 LabCreditReportWebService 

Fr3 tAJr.l". Cik-. fi 1 ■%« n.n -.kiniP% 

Customize Perspective... 

Save Perspective As... 

Reset Perspective 

Close Perspective J- [ 

Close All Perspectives 


This will close the J2EE perspective and return focus to the Business Integration perspective. 
The top right corner of the main window displays the current perspective. 


i Business Integration - \ssembly Diagram' SimpleAccountVer 


File Edit Navigate search Project Run Window Help 



_ r£h 


m - J J o* - J # J ^ 



I. In the Business Integration view, verify that the Credit Report web service appears under Web 
Service Ports. 



- SimpleAccountVerification 

in© f^SISSSFSBSBl 

Dependencies 
+ <_ Business Logic 
+ «- DataTypes 
+ 1 Interfaces 

+ - Mapping 

?' Events 

* W eb Service Ports _ 

Import 1 jlreditReportHttpPort 


2. Change the Credit Report task to a Web Service Implementation 
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a. From the Assembly Diagram editor, select the CreditReport component, then press the delete 
key. 




CreditReport_359917159 


<-- Delete 


b. From the tree view, select lmport1_CreditReportHttpPort. Using the left mouse button, drag and 
drop lmport1_CreditReportHttpPort into an empty space in the Assembly Diagram editor. 


Business Integration X 


© & 3 


3 )*Assembly Diagram: Simple Account 1 Verification £3 

B 


- £§3 SimpleAccountVerification 
+ i. ] Assembly Diagram 
± Dependencies 
+ & Business Logic 
+ S Data Types 
+ 1 Interfaces 

+ - Mapping 

?' Events 

v Web Service Ports 


Lii * 

■4rTT»' 

<&> 

% 



f* 


5impleAccountVerification_02£ 


Import 1 _CreditReportHttpPort 



c. Select Import with Web Service Binding, then click on OK. 



A CreditReport Web Service component will appear in the Assembly Diagram editor. 
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iness Integration £3 

ffl & B % 

SimpleAccountVerification 
l ) Assembly Diagram 
Dependencies 
& Business Logic 
*— DataTypes 
1 Interfaces 
- Mapping 
?' Events 

* Web Service Ports 
1 .® Import 1 _CreditReportHttpPort 




m Z ^Assembly Diagram: simpleAccountVerification X 




c*> 





© -v^CreditReportlmportl 


1 


c i- 


B 4 


Simple Account VeriFication_0266109845 


d. From the palette on the left, select the Wire icon. 


m m * Assembly Diagram: SimpleAccountVerification X^^® 



j ^ > 

1 


m .v^CreditReportlmport: 

G» 

T 



© 

® ^ 5impleAccountVerification_026610' 


This will switch the editor to ‘wire’ mode, which will make it easier to connect components in the 
Assembly Diagram editor. 

e. Left-click on the CreditReport reference point on the SimpleAccountVerification process 
component. This will start a connection (blue line). 



f. Click on the CreditReportlmportl component. This will complete the new connection highlighted 
in yellow below. 
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i) fy CreditP.eportlrnportl 



*: SimpleAccountVerif ication_0266109845 


■ t Simple Account Verification_0266109845 



g. From the palette, click on the Selection Tool icon to switch back to selection mode. 



h. Right-click on an empty space in the Assembly Diagram editor. From the popup menu, select 

Layout Contents. 


2^ Zoom In 
2^ Zoom Out 


Ctrl+= 

Ctrl+- 


Arrange Contents Automatically 
Layout Contents 

Test Module 


This will rearrange the CreditReportlmportl component for a cleaner layout, 

i. Press Ctrl-s to save the modified assembly. 

3. Retest the SimpleAccountVerification Process 

a. Switch to the Servers view. 

b. Right-click on the WebSphere Process Server v6.0 test server. From the popup menu, select 

Add and remove projects. 
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i + i 


i-i 



Properties 


Problems 




>■ Servers X 


Com 


Server 


Monitoring 


^WebSphere Process Server v6.0 


Ad d and remove projects... 


Run universal test client 
Restart universal test client 
Run administrative console 

Reconnect debug process 

[ J Create tables and data sources 

Import server configuration from server 
Export server configuration to server 

Launch 


lame 


c. From the Add and Remove Projects window, click on Add All 


Move projects to the right to configure them on the server 
Available projects: 


“7T 

El □ 

+ 5impleAccountVerificationA 


LabCreditReportService 


Add > 


< Remove 


Configured projects: 



d. Click on Finish. This will add the business process to the test server configuration. 

e. A progress indicator will appear in the lower-right corner of the WebSphere Integration Developer 
window. Wait for this indicator to disappear before proceeding to the next step. 



j. Focus will automatically switch to the Console view. Verify that a message appears in the 
Console view indicating that the SimpleAccountVerificationApp process has started. Scroll 
right as needed. 


Simple Service Oriented Architecture Lab 


Page 62 of 171 























































© Copyright IBM Corporation 2007. All rights reserved 


Console X 


.0 [WebSphere v6.0 Server] WebSphere Process Server v6.0 (Websphere v6.0) 

com.ibm.us.al.bootstrap.WASBootstrap appStart(DeployedApplication) CW 
S C A_S TARTING_AP P_MOD UL E 
5 C A_S TARTE D_AP P_HOD UL E 

WSVR0207I: Preparing to start EJB jar: SimpleAccountVerificationEJB 
WSVR0037I: Starting EJB jar: SimpleAccountVerificationEJB.jar 
J2CA0306I: Applic ation SimpleAccountVerificationApp#Simp leAccou ntVe 
WSVR022 lit Application started: SimpleAccountVerificationApp 



.9 


Switch to the Servers view and right-click on WebSphere Process Server v6.0. From the popup 

menu, select Launch->Business Process Choreographer Explorer. 



The Business Process Choreographer Explorer appears. This is a built-in web application that 
provides a way to manage business processes, as well as work items associated with human 
tasks in the process. 

h. Click on the My Process Templates link to display a list of processes which can be started. 


l 3 Assembly Diagram: SimpleAccountVerification 

r -JP '’l 

" Business Process choreographer Explorer * 

< 

Welcome: (English) 

Help 




0 Process Te mi plates 

[i 

My Tasks 


My Process Templates^'^- 


Place a checkmark beside the SimpleAccountVerification process template, then click on Start 
Instance. 
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Available Actions 


r 

Start Instance Instances 


View Structure 


R ef re s h 







.■■■■■. 

v 


Process Template Name 
© SimpIeAccountVerification 0266109345 

Items found: 1 Items selected: 1 


Valid From 0 
2/10/07 8:12:0 


< 


This will start the SimpleAccountVerification business process, and display the default input page. 
From the default input page, click on the Expand button. 



Process Template Name SimpleAccountVerification_0266109845 
Operation InputCriterion 


Process Name 
Process Input Message 


Input 


applicationID 

applicationDate 

pricing 

requestedLimit 

customer 

creditScore 
ere d itP. e p o rtR e q u i re d 
a p p I i cati onDecision 
ere d itR i s k As sessment 


2/11/07 


0.0 


<Q> 


false 


false 


k. For the customerlD field, type 123, accept the defaults for the other fields, then click on Submit. 

Submit | 


Input 


applicationID 

applicationDate 

pricing 

requestedLimit 

customer 


2/11/07 


0.0 


customerlD 

companyName 


C 



123 

\ 
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A Customer ID of “123” will again result in a low credit score and a denied request. Any other 
Customer ID value will result in an approved request. However, this time the messages will 
indicate that a web service is invoked instead of the previous Java code. 



CHFF0019I: The Transport Channel 

__SRVE02^2 > Ij_[ i LahiCreditRe p o r t S e r v i c 
********************* 

* Call Ueb Service * 
********************* 



O >>>>> Credit Score = 449 

0 >>>>> Credit risk = HIGH 
O >>>>> Request is denied!. 


l. When you’re done testing the business process, switch to the Servers view. 

m. Right-click on the WebSphere Process Server v6.0 test server. From the popup menu, select 

Add and remove projects. 


r 

Properties 

W 

Servers 

Add and remove projects... j 


Server 

Run universal test client 

Jjosl 

|i!^WebSphere Process Server v6.0 

Restart universal test client 

ioca 



Run administrative console 




Reconnect debug process 



n. From the Add and Remove Projects window, click on Remove All. 

o. Click on Finish. 

p. Close the Business Process Choreographer Explorer. 


Assembly Diagram: SimpleAccountVerification 

Business Process Choreographer Explor^ 



Welcome: (English) 

Help 


STOP 

BE B ■ 


Please wait for the next lecture before proceeding with the lab. 
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Part 6: Business Rules 



SOA improves businesses’ ability to meet market needs 

By providing a more flexible infrastructure 


With SOA, IT is flexible 
and responsive to 
business needs 


Flexibility 



Without SOA, IT can't easily keep up 
with fast changing requirements of 
customers, partners, and competition. 



Imagine if your business 
could do that 


Do you need superhuman strength to 
make changes to your business? 


If innovation is defined as the process of making changes to do 
something new. which method would be best for innovation? 



Changes in your business environment often involve the need to adjust business variables 
such as discount rates, fees, or product pricing based on promotions, time of year, etc. It 
might also involve modifications to business algorithms or decision tables. Business 
processes need to be able to quickly adapt to these changes, without time, cost, and 
resource-intensive development and maintenance work. 

The Business Rules capability of the WebSphere Process Server can provide that type of 
business flexibility, where business variables and formulas can be loosely-coupled or 
externalized from the business processes. This feature allows for quick and easy 
modifications to these business rules without recoding, redeployment, or retesting. 

The Business Rules feature of the WebSphere Process Server also adheres to the 
building-block approach, where these business rules are modularized and treated just like 
any other service component. This will be illustrated in this part of the lab where you will 
quickly change the Credit Risk Assessment task from a Java implementation to Business 
Rules. 


1. Change the Credit Risk Assessment Task to a Business Rule 
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a. From the Assembly Diagram editor, right-click on the CreditRiskAssessment_2053491712 
component. 



b. From the popup menu, select Change Type. 



Change Type... 


Convert to Import 

Generate Export... 

Regenerate Implementation 
Select Implementation 
Open 

Synchronize Interfaces and References.. 


] G 3 Component (No Implementation) 
1) Human Task 

^ Java 

Process 

3 



Rule Group 


State Machine 


This will change the implementation type from Java to a Rule Group. The logic to determine 
whether the risk assessment rating is HIGH or LOW, used to be in Java code. It will now be 
replaced by a Business Rule for better flexibility. 


d. Double-click on the CreditRiskAssessment_2053491712 component. 


"4 


CreditRiskAssessment 2053491712 


e. From the Open window, click on Yes. 
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An empty Business Rule Group will be created. The next step is to define the specific rules to 
determine if the credit risk assessment rating should either be HIGH or LOW based on the credit 
score. 

f. From the Generate Implementation window, click on OK. 



Gene raleJmplementalipn, 


Select the folder where the Rule Group implementation will be generated: 


SimpleAccountVerification 


- # _ 

\^p businessitems 

Q^p businessserviceobjects 

+ Qfy processes 

+ L-—^ sea 



OK 



Cancel 


The Business Rule Group editor appears. 

2. Define the Business Rule Set 

a. From the Business Rule Group editor, click on the InputCriterion Interface. 
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:+: Assembly Diagram: 5impleAccountVerification 

6 

CreditRiskAssessment ,2053491712 X^ 



General 


▼Interfaces ^ 


▼ ■£ CreditRiskAssessment 

O ^ 0 InputCriterion 


▼References ^ 





A Business Rule Group contains related Business Rules. In other words, A Business Rule Group 
is a logical grouping of related Rules. 

b. Click on the Enter Destination link. 


5*Assembly Diagram: 5impleAccountVerification 

i 

CreditRiskAssessment 2053491712 X^ 



General 


▼Active Destinations 


■S> X 


▼Interfaces 



O Default Destinati 


* 




En ter Destin a don 


:> 


G 



■ CreditRiskAssessment 

^ InputCriterion 



Start Date 

End Date 

Destination 





c. Select New Ruleset from the popup list. 



CreditRiskAssessment 2053491712 X 


▼Active Destinations 


-n- 


O 


Default Destination 


Enter Destshatsb 


I 


Start Date 

End Dat^ 




None 


New Ruleset... 


New Decision Table, 



d. From the New Rule Set window, accept the defaults and click on Finish. 
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4* New Ru le Set 


File Name 

Specify the name and the location for the new file. 




Module: pimple Account Verification 

New... | 

Namespace: | http://5impleAccountVerification 

1^ Default 

Folder: | 

Browse... 

Name: | InputCriterion 






The Rule Set editor appears. 

From the InputCriterion Rule Set editor, click on the Add If Then Template icon. 



The next step is to define a business rule where the risk assessment will be rated “HIGH” if the 
credit score from the CreditReport web service is less than a certain threshold. In the previous 
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Java implementation, the threshold was fixed at 500. In this business rule, it will be a variable that 
can be changed at runtime. 

f. In the Templates section of the Rule Set editor, click on the Add Template Parameter icon. 


^Templates ^ X 



Name 

Template 1 

o 

Presentation 



Parameters 

Name 

Type 

Constraint ( 





o 

If 

! fen Ann"! 

o 

Then 

! Act/bn 

"1 



g. Change the new Parameter Name from paraml to threshold. 


Name 

Template 1 

Presentation 


Parameters ^ 

Name 

Type 

Constraint 

threshold 


None 

If 

! Condition ! 

Then 

! Action* 


h. Click on the Select Type link. 


Name 

Template 1 

Presentation 


Parameters 

Name 


Constraint 

threshold 

- v 

yekct fypS JO 

None 

If 



Then 

\ Action * 


i. From the popup list, select int. 


Name 

Type 

Constraint 

threshold 

HSRRHfffi o 

None 


! Condition ! 

string 



! .4riT/ar ’! 1 

int 



Servers 53" 

double 

boolean 




float 

long 

short 

byte 



3 ss Server v6.0 




Take note of the red Y marks (°) highlighted below. This indicates that an error exists in that 
specific field. That is to be expected at this point because the proper values still have to be 
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specified. 



Name 

o 

Presentation 


Parameters 

G 

If 

G 

Then 


j. Click on the Condition link in the If field. 


Name 

Template 1 

Presentation 


Parameters 

Name 

Type 

Constraint 

threshold 

int 

None 

If c 

! ConcfrF/dn'i 

Then 

■ a cam I 


k. Ignore the popup list and just type the following into the If field: 

Input.creditScorecthreshold 


Name 

Template 1 

Presentation 


Parameters 

Name 

Type 

Constraint 

threshold 

int 

None 


ff C 

Input, creditScore <threshold j 

Then 

\ Action'* 


The red ‘x’ mark (°) beside the If field should disappear if the Condition value was specified 
correctly. 

I. Click on the Action link in the Then field. 


Name 

Template 1 

Presentation 


Parameters 

Name 

Type 

Constraint 

threshold 

int 

None 

If 

Input .creditScore threshold 

Then ^ 

I Act/on ! 


m. Ignore the popup list and type the following into the Then field: 
Output.creditRiskAssessment=”HIGH” 
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Name 

Template 1 

Presentation 


Parameters 

Name 

Type 

Constraint 

threshold 

int 

None 


If 

— 

Innut. credit5core <threshold 

Then Q 

Output. creditR!skAssessrnent= M HI«jH 11 



The red ‘x’ mark (°) beside the Then field should disappear if the Condition value was specified 
correctly. 

Type the following into the Presentation field: 

If credit score is less than {threshold} then risk assessment is HIGH 


Name 

Template 1 

Presentati^ 

If credit score is less than Ithreshold^then risk assessment is HIGH j 

Parameters 

Name 

Type 

constraint 

threshold 

int 

None 


If 

Input. credit5core threshold 

Then 

Output. creditRiskAssessment="HIGH" 


The text specified in the Presentation field will be displayed in the Business Rules Manager user 
interface. The Business Rules Manager will allow you to dynamically change the parameter 
values in the template rule while the process is running. In this case, the threshold parameter 
can be changed at runtime to affect how the risk assessment rating is determined, without having 
to modify, retest, and redeploy the process. This will be illustrated later in the lab. 
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o. In the Rules section, click on the Add Action Rule icon. 


* Assembly Diagram: SimpleAccountVerification 


*CreditRiskAssessment 2053491712 


Ji 


*Inpu 


Input(s) 

Input 

Customer Application 

Output(s) 

Output 

CustomerApplication 


▼Variables ^ 


Name 

Type 





▼Templates ^ $ji] X 


Name 

Template 1 

Presentation 

If credit score is less than : threshold 1 then risk assessment is HIGH 

Parameters 

Name 

Type 

Constraint 

threshold 

int 

None 

If 

Input. credit5core threshold 

Then 

Output. creditRiskAssessment="HIGH" 


p. Click on the Action link in the Action field. 

▼Rules #J * .Q # X 


Name 

Rulel 

Presentation 


Action 


•Action i 



In the previous steps, you had ignored the popup list which appears when a field link is clicked to 
keep the steps simple. However, the popup lists can also be very useful in supplying the proper 
values for the fields. Let’s try it in the next step. 

q. From the popup list, select Output: CustomerApplication. (Output is a property from the Rule 
Set Interface, and CustomerApplication is the property type.) 
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Name 

Rulel 

Presentation 


Action 

UB50S 



j Set varl to var2 

Call a method 

+ =3= Input : CustomerApplication 


miplates § 


Name 

Ten 

f Output : CustomerApplication 

5 

Presentation 

If c 

Create BO 

CO Copy BO 

JT Invoke 

V 1 return 

risk assessment is HIGH 

Parameters 

Nan 


thrf 


rties Problems 

tfi: 

O % 

er 

Host name 

'ebSphere Process Si 

localhost 

< > 


r. From the popup list, select the “=’ operation. 


Name 

Rulel 

Presentation 


Action 

Output 

mplates 

0 

^* = 


■Ci Jj 

* == 

; 

* ! = 
j. e.o , 


Name 

Template 



s. From the popup list, select Input: CustomerApplication. 


Name 

Rulel 

Presentation 


Action 




Ll 

^ Input : CustomerApplication 


‘mplates 


+ Output : CustomerApplication 

Q Create BO 

1 . CO copy bo 


Name 

Template 1 


Presentation 

If credit see 

;essment is HIGH 


Setting up this Action in the Business Rule will copy the contents of the Input variable to the 
Output variable. The Input variable is a parameter passed into this Rule Set when this Business 
Rule is invoked. The Output variable will be passed back to the component invoking this 
Business Rule when execution is complete. 


Name 

Rulel 

Presentation 


Action 

•Output = Input | 


t. While the cursor is still in the Action field, press the Enter key. This will add another Action link 
to the Action field. 
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u. Click on the new Action link. 


Name 

Rulel 

Presentation 


Action ^ 

Output = Input 
y/rrmri j 


v. Ignore the popup list again and type the following into the second line of the Action field: 
Output.creditRiskAssessment=”LOW” 


Name 

Rulel 

Presentation 


Action 

Output = Input 

Output .creditRiskAssessment= M LOW" 


w. Click on the Add Template Rule icon in the Rules section. 


^Rules X 13 X 


Name 

Rulel 

Presentation 


Action 

Output = Input 

Output, creditRiskAssessment="LO' W" 


x. From the popup list, select Template 1. 



This will create an empty Rule based on the Rule Template created earlier, 
y. Specify a value of 500 for the threshold variable in the Presentation field of Rule2. 

Allies m H # X 


Name 

Rulel 

Presentation 


Action 

Output = Input 

Output. creditRiskAssessment="LO W" 


Name 

Rule2 

Template 

Template 1 

Presentation 

If credit score is less the 

£ 

ML 

3 

hen risk assessment is HIGH 


The Business Rule is now complete. This Rule Set basically recreates the logic in the previous 
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Java implementation where the risk assessment will be HIGH if the credit score is less than the 
current threshold level of 500. The significant difference is that this was done without any 
programming, and the threshold value can be changed dynamically at runtime. This provides 
tremendous flexibility in the execution of business processes. 


3. Save and Verify the Business Rule 

a. Press Ctrl-s to save the Rule Set. 

Hint: A red ‘x’ mark (°) might still be visible beside the Presentation field of Rule2. This should 
disappear when the parent Rule Group is also saved. 

b. Close the InputCriterion Rule Set editor. 



Focus should return to the CreditRiskAssement_2053491712 Business Rule Group. 


* Assembly Diagram: SimpleAccountVerification 


^CreditReassessment 2053491712 X 




General 


▼Interfaces 


W I 

■ CreditRiskAssessment 


6 

InputCriterion 



▼References 


V 1 


▼Active Destinations 


x 


Default Destination 


InputCriterion 


Start Date 

End Date 




Destination 


Selection criteria 


Current date 


▼Available Destinations 


x 


InputCriterion 


c. Press Ctrl-s to save the Business Rule Group. 

d. Close the CreditRiskAssement_2053491712 Business Rule Group editor. 


* Assembly Diagram: SimpleAccountVerification 


~ CreditRiskAssessment 2053491712 X 


Focus should return to the Assembly Diagram editor. 

e. From the Assembly Diagram editor, press Ctrl-s to save the modified assembly. 

f. Switch to the Problems view. Verify that no errors exist (messages with a red‘x’mark ). 
Warnings and informational messages are acceptable. 


4. Retest the SimpleAccountVerification Process 

a. Switch to the Servers view. 
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b. Right-click on the WebSphere Process Server v6.0 test server. From the popup menu, select 

Add and remove projects. 


i + i 


!-! 



Properties 


Problems 




>■ Servers X 


Com 


Server 


Monitoring 


Add and remove projects... 




^WebSphere Process Server v6.0 


Run universal test client 
Restart universal test client 
Run administrative console 

Reconnect debug process 

[ J Create tables and data sources 

Import server configuration from server 
Export server configuration to server 



Launch 


c. From the Add and Remove Projects window, click on Add All. 


Move projects to the right to configure them on the server 
Available projects: 


Configured projects: 


“ n 

0-tfi 


LabCreditReportService 


q SimpleAccountVerificationA 


Add > 


< Remove 



d. Click on Finish. This will add the business process to the test server configuration. 

e. A progress indicator will appear in the lower-right corner of the WebSphere Integration Developer 
window. Wait for this indicator to disappear before proceeding to the next step. 


Add and Remove Projects 



f. Focus will automatically switch to the Console view. Verify that a message appears in the 
Console view indicating that the SimpleAccountVerificationApp process has started. Scroll 
right as needed. 
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Console X 


.0 [WebSphere v6.0 Server] WebSphere Process Server v6.0 (Websphere v6.0) 

com.ibm.us.al.bootstrap.WASBootstrap appStart(DeployedApplication) CW 
S C A_S TARTING_AP P_MOD UL E 
5 C A_S TARTE D_AP P_HOD UL E 

WSVR0207I: Preparing to start EJB jar: SimpleAccountVerificationEJB 
WSVR0037I: Starting EJB jar: SimpleAccountVerificationEJB.jar 
J2CA0306I: Applic ation SimpleAccountVerificationApp#Simp leAccou ntVe 
WSVR022 lit Application started: SimpleAccountVerificationApp 



.9 


Switch to the Servers view and right-click on WebSphere Process Server v6.0. From the popup 

menu, select Launch->Business Process Choreographer Explorer. 



The Business Process Choreographer Explorer appears. This is a built-in web application that 
provides a way to manage business processes, as well as work items associated with human 
tasks in the process. 

h. Click on the My Process Templates link to display a list of processes which can be started. 


l 3 Assembly Diagram: SimpleAccountVerification 

r -JP '’l 

" Business Process choreographer Explorer * 

< 

Welcome: (English) 

Help 




0 Process Te mi plates 

[i 

My Tasks 


My Process Templates^'^- 


Place a checkmark beside the SimpleAccountVerification process template, then click on Start 
Instance. 
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Available Actions 


r 

Start Instance Instances 


View Structure 


R ef re s h 







.■■■■■. 

v 


Process Template Name 
© SimpIeAccountVerification 0266109345 

Items found: 1 Items selected: 1 


Valid From 0 
2/10/07 8:12:0 


< 


This will start the SimpleAccountVerification business process, and display the default input page. 
From the default input page, click on the Expand button. 



Process Template Name SimpleAccountVerification_0266109845 
Operation InputCriterion 


Process Name 
Process Input Message 


Input 


applicationID 

applicationDate 

pricing 

requestedLimit 

customer 

creditScore 
ere d itP. e p o rtR e q u i re d 
a p p I i cati onDecision 
ere d itR i s k As sessment 


2/11/07 


0.0 


<Q> 


false 


false 


k. For the customerlD field, type 123, accept the defaults for the other fields, then click on Submit. 

Submit | 


Input 


applicationID 

applicationDate 

pricing 

requestedLimit 

customer 


2/11/07 


0.0 


customerlD 

companyName 


C 



123 

\ 
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A Customer ID of “123” will again result in a low credit score and a denied request. In this case, it 
used the Business Rule to determine that the credit risk assessment is LOW because the credit 
score is below the current threshold of 500. Based on the risk rating, the process automatically 
rejected the request. 


0 ********************* 

O * Call Web Service * 

0 ********************* 

Q >>>>> Credit Score = 449 
I J2CA0O86W: Shareable conne 

O >»» Request is deniei 


ii TiTi t 

:d! 7 ) 


However, because the credit risk assessment is now implemented as a Business Rule, the next 
few steps will illustrate how this will provide greater business flexibility. 


5. Modify the Credit Assessment Business Rule at Runtime 

a. Click on the Internet Explorer icon in the Quick Launch bar. There is also an Internet Explorer 

icon on the desktop. 


start f ' * 


b. From the Internet Explorer window, click on the Business Rules Manager link. The link will 
open the URL http://localhost:9083/br/webclient/ . 

Using a standard web browser, an authorized person such as a manager or business analyst, can 
dynamically change the behavior of the business process at runtime by modifying the externalized 
business rules. 

c. From the Rule Books tree view on the left, click on InputCriterion. 
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SlB usiness^Rules^ManageAgiMic rosoft I nte r net Exp lo re r 


File Edit View Favorites Tools Help 


© 


Back T 



1*1 l*'] © ^ Search * Favorites 


ISi 


% 


Address 


m http://localhost:9083/br/webdient/pages/index.jsp 


Links U WAS Admin Console WSRR Console dQ BPC Explorer J Portal z£| BPC Observer 


Alphal 


Welcome 


Logout 


Help 


Publish and Revert 


Rule Books 


Rule Books 

EB Ij^ CreditRiskAssessmentBusinessRule 
□ [jj|j CreditRiskAssessment_2053491 71 2 


□ R InnutCriterion 
d InputCriterion ^ 


Business Rules Resources 

El lfi| CreditRi; kAssessm intBusinessRule 
El l^| CreditRis : Assessment 2 153491712 


The logon window did not appear because security is disabled in the test server. In a secure 
production environment, users will be required to log in and business rules can only be accessed 
by authorized users. 

d. From the InputCriterion Ruleset pane, click on Edit. 


InputCriterion - Ruleset 

| , 

Bacrf | Edit | Copy 


General Information 


Last Published 

Feb 1 5, 2007 0S:5S (Local Time) 

Description 



Rules 


Name 

Rule 

Rule2 

If credit score is less than 500 then risk assessment is HIGH 


This is the ruleset for the Credit Risk Assessment Business Rule. The current threshold of 500 will 
be lowered so that the request of Customer ID 123 will be accepted. 
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e. From the Ruleset editor, change the threshold value to 300, and then click on Save. 



Welcome | Logout | Help 



(^Publish and Revert^! 

Rule Books 

InputCriterion - Ruleset 

Messa 

0 ij|j) CreditRiskAssessmentBusinessRule 
□ lj||) CreditRiskAssessment_2053491712 

Back | Edit | Copy 


g. From the Publish and Revert pane, click on Publish. 


Welcome | Logout | Help 

Publish and Revert 

Publish and Revert 

>>“ “S. 

■ Rule Books 

EB ii[hj CreditRiskAssessmentBusinessRule 
□ i|| CreditRiskAssessment_2053491 71 2 

Back ( Publish } Mess: 


□ [3] InputCriterion 
§ InputCriterion 

Changed Business Rules Resources 

To revert local changes, press "Revert 11 button. 


The Messages box should indicate that the rule change was published successfully. 
Messages: Selected rule page(s) have been published successfully. 

h. Minimize the Internet Explorer. 

i. Switch to the WebSphere Integration Developer. 
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From the Business Process Choreographer Explorer, click on the My Process Templates link to 
display a list of processes which can be started. 


t ) Assembly Diagram: SimpleAccountVerification 


Business Process choreographer Explorer 


Welcome: (English) 


Help 


Process Templates 
~ P ro ce s s" Te m p I ate s 




My Tasks 


m. Place a checkmark beside the SimpleAccountVerification process template, then click on Start 
Instance. 



Available Actions 


r Process Template Name 0 

SimpIeAccountVe rif ication 0266109345 

Items found: 1 Items selected: 1 



Valid From () 
2/10/07 3:12:0 


This will start the SimpleAccountVerification business process, and display the default input page, 
n. From the default input page, click on the Expand button. 


S u b m it 


Process Template Name 
Operation 

Process Name 
Process Input Message 


S i m p I eAcco u ntV e rif i cati o n_0 266109345 
InputCriterion 
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j. For the customerlD field, type 123, accept the defaults for the other fields, then click on Submit. 

Submit | 


Input 


applicationID 

applicationDate 


pricing 


requested Limit 


customer 


2/11/07 


0.0 


customerlD 

companyName 


C 


123 


5 


A Customer ID of “123” should now result in an accepted request because the threshold level in 
the Credit Risk Assessment Business Rule was lowered to 300. 


o ********************* 

O * Call Web Service * 

O ********************* 

>>>>> Request is approved 


Significant cost reductions can result from this type of business and IT flexibility. 


6. Reset the Credit Risk Assessment Business Rule 

a. When you’re done testing the business process, switch to the Servers view. 

b. Right-click on the WebSphere Process Server v6.0 test server. From the popup menu, select 

Add and remove projects. 


r 

f 

Properties 

-V Servers 

\ Add and remove projects... J 


Server 

Run universal test client 

Hosl 

|i!^WebSphere Process Server v6.0 

Restart universal test client 

loca 



Run administrative console 




Reconnect debug process 



c. From the Add and Remove Projects window, click on Remove All. 

d. Click on Finish. 
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e. Close the Business Process Choreographer Explorer. 


l Assembly Diagram: SimpleAccountVerification 

tJ Business Process Choreographer Explor^ S3 } 

Welcome: (English) | Help 



f. Switch to the Internet Explorer with the Business Rules Manager page. 
_g. Click on the InputCriterion link again. 


Publish and Revert 


Rule Books 

El lqh| CreditRiskAssessmentBusinessRule 
□ l^| CreditRisk4.ssessment_2053491712 
H |h) InputCriterion 
InputCriterion 


Publish and Revert 


Back 


Publish 




Changed Business Rules Resources 

There are no unpublished changes. 


h. Click on Edit. 


InputCriterion - Ruleset 



i. Change the threshold value back to 500, then click on Save. 


Rule 

If credit score is less th 



en risk assessment is HIGH 


j. Click on the Publish and Revert link. 


Publish and Revert 


k. Click on the Publish button 


Publish 


Messages: Selected rule page(s) have been published successfully. 


I. Close the Internet Explorer. 



Please wait for the next lecture before proceeding with the lab. 
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Part 7: Human Tasks 



SOA aligns businesses for growth 

By tightly aligning IT to business processes 


With SOA, building blocks for IT 
are business services 


Without SOA, IT is organized 
by infrastructure components 


Business services are things like... 


JP “Clieclung patient records 

+ 


ra 


“Making a flight reservation 11 




i; 


Opening a bank account 


PH 



A ppl i cations Ha rdwane N etworki ng 


Which approach do you think is better 
for improving business processes? 



Business processes often involve human intervention, such as a loan officer reviewing 
loan applications, or a manager approving employee reimbursements. There will always 
be situations where systems or programs cannot automatically make decisions based on 
the available information. A business process might also involve a trivial task such as a 
secretary manually sending fax requests to print promotion materials. Because the goal is 
to implement the entire process end-to-end, then manual tasks need to be included with 
the automated tasks. With IBM’s SOA Foundation and the WebSphere Process 
Integration software portfolio, human activities are fully supported in business processes. 

In fact, the human task capabilities in the WebSphere Process Server are also designed 
for loose-coupling, effective reuse, and the building-block approach. 

In this section, the implementation type for the Pricing and Approval task will be 
converted from Java to a human task. The SimpleAccountVerification BPEL process 
will also be modified to add a new task called Generate Acceptance. The Generate 
Acceptance task is being added simply to display output from the Pricing and Approval 
human task. This will also help introduce BPEL development. 
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1. Define the Interface for the new ‘Generate Acceptance’ task. 

a. From the Business Integration tree view, right-click on Interfaces. From the popup menu, select 

New -> Interface. 




Business Integration 


ffl & B % 


- £5 BimpleAccountVerification 
Assembly Diagram 
Dependencies 
+ & Business Logic 

Daha TypR^r - 



Interfaces 


+ cS napping 
? Events 
-■■■ Web Service F 
Import 1_( 


New 


Open 


1 Copy 
| Paste 
Delete 


in 


>- ) Assembly Diai 

B 


* 

o 


Project... 


^ Interface 

* Other... 

Ctrl+N 

1 [ 




An interface first needs to be defined for the Human Task. An interface consists of operations and 
the inputs and outputs associated with each operation. A Human Task component is handled just 
like any other service component, so it also needs to be invoked using a clearly defined set of 
operations and its associated inputs and outputs. 


At first it might be a scary thought knowing that we humans can now be invoked just like any other 
software component, but this is actually a powerful feature. Because the Human Task component 
is also a generic building block where the internals are hidden and only the interface is exposed, 
then it becomes easy to swap different building blocks even though the internals involve different 
technologies, programming languages, and operating environments. This is one of the ways IT 
flexibility is achieved. 

b. From the New Interface Wizard window, specify GenerateAcceptance for the Name, then click 
on Finish. 
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c. From the GenerateAcceptance Interface editor, click on the Add Request Response Operation 

icon. 


Assembly Diagram: SimpleAccountVerification 

GenerateAcceptance X 


▼Operations M jjjrfj 

Operations and their parEme 

fe | 

:ters 

1 & jp m 



Name 


d. Specify generateAcceptance as the operation name. 


^Operations p pt] ^ 


Operations and their parameters 



Name 

| generateAcceptance j 

5 

Dl Input(s) 

inputl 

ID Output(s) 

output 1 


e. Click on the string link for inputl. 
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ountVerification 

: r Generate Acceptance 

k _ 

1 

-s 

& p m 

m 

Name 

Type 


input 1 
output 1 



When the generateAcceptance operation is invoked, a parameter variable named inputl will be 
passed. By default, the parameter inputl is defined as a string type. This will need to be 
changed to use the CustomerApplication business object type instead. 

From the popup list, select Browse. 



strina 







New.., 




C boolean 




C date 
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g. From the Data Type Selection window, select CustomerApplication, then click on OK. 



h. Change also the type of outputl to CustomerApplication. 


Name 

Type 


input 1 

CustomerApplication 

outputl 

c 

CustomerApplication 


During execution, when the generateAcceptance operation has completed, a result variable 
named outputl will be passed back to the calling component. 

Press Ctrl-s to save the new Interface. 


j. Close the GenerateAcceptance Interface editor. 
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2. Add the GenerateAcceptance Task to the SimpleAccountVerification BPEL 
Process 

a. From the Assembly Diagram editor, double-click on the SimpleAccountVerification 

component. 


■ f / 5impleAccountVerification_0266109845 



The SimpleAccountVerification BPEL editor will appear. 



This is the BPEL version of the SimpleAccountVerification business model developed earlier 
using the WebSphere Business Modeler. 


b. Right-click on an empty space in the BPEL editor. From the popup menu, select Align Parallel 
Activities Contents Automatically. 


Sj^Zoom In 

- 1 

Ctrl+= 

S^Zoom Out 

Ctrl+- 

^Align Parallel Activities Contents Automatically 


] Show in Properties 


This option will make the editor always automatically adjust the BPEL diagram to the optimum 
layout. 
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c. From the tree view and using the left mouse button, drag and drop the GenerateAcceptance 
Interface to an empty space in the BPEL editor. 


te: Business Integration Ei 


Assembly Diagram: SimpleAccountVerification 



$ & El 


% 


- SimpleAccountVerification 
+ l ) Assembly Diagram 
Dependencies 
& Business Logic 
+ 6 DataTypes 
1 Interfaces 

|.(J) CreditReport 

,-CceditRiskAsse^roent 

(I ) GenerateAcceptance 
Generateuedine 


(T) PricingandApproval 
(i) SimpleAccountVerification 


k 

1" " " 1 

1 1 

L "-+ 



□ > 

^>> 


« 

V. 

HI 


P 

k 

P 

Pricing and. 

k 


This will add the GenerateAcceptance Interface to the list of Reference Partners, making it 
available for use by any task or activity in the BPEL process. 




SimpleAccountVerification X 





_ I 

□ 

SimpleAccountVerification 
■_ -■ 

5'|> Interface Partners ^ 31 

SimpleAccountVerificationPartner 
Reference Partners O X 

CreditReportPartner 
CreditRiskAssessmentPartner 
PricingandApprovalPartner 
GenerateDedinePartner 
GenerateAcceptance 
w Variables ^ H 

CustomerApplicationVariable 
Correlation Sets 


d. From the Activity Palette of the BPEL editor, click on the Empty Action icon. 





■ i 


m 

"■■■+ 



i 

© 


r 

O SimpleAccountVe 

k 



i 

5 :> Credit F 

H 

V 

jr 

k 

T 
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This will open a sub-palette, 
e. From the sub-palette, click on the Invoke icon. 


Q 


□ > 


e 



This will load the cursor with the Invoke activity and is ready to be dropped on to the BPEL 
diagram. 

f. Click on an empty space in the BPEL diagram. 






This will add a new Invoke activity to the BPEL diagram. 



1 


*1 SimpleAccountVerificationReceive 


J 

1 I X 
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g. Change the name of the new Invoke activity to Generate Acceptance. 

m 





h. Click to select the link between the Pricing and Approval activity and the 

SimpleAccountVerificationReply activity. 



i. Press the Delete key. 

j. Right-click on the Pricing and Approval activity. From the popup menu, select Add Link. 
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BimpleAccountVerificationReceive 


Generate Acceptance 




Credit Report 




Pricing and Approval) ^'undo Delete Link 


t[>Redo 


X Add Fault Handler 

jjh Add Compensation Handler 
@ 5et Partner 

Add Link 


Insert Before 

► 

Change Type 

► 


This will start a connection. 

k. Click on the Generate Acceptance activity to complete the connection. 



l. Right-click on the Generate Acceptance activity. From the popup menu, select Add Link. 

m. Click on the SimpleAccountVerificationReply activity to complete the connection. 
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n. Verify that the SimpleAccountVerification BPEL process looks similar to the screenshot below. 



o. Right-click on the Generate Acceptance activity. From the popup menu, select Set Partner. 

p. From the Select a Partner window, select GenerateAcceptance, then click on OK. 


-t* Setect a Partner 


Partner Name (? = any character] :+: = any String): 

New, 



Matches: 


CreditReportPartner 
CreditRiskAssessmentPartner 
GenerateAcceptance 
GenerateDecHneF'artner 

PricingandApprovalPartner 





Simple Service Oriented Architecture Lab 


Page 97 of 171 

























































© Copyright IBM Corporation 2007. All rights reserved 


q. With the Generate Acceptance activity still selected, switch to the Properties view and click on 
the Details tab. 


,+> 


i-l 





Problems 



Servers 


Console 


Generate Acceptance 

Partner: GenerateAcceptance 

TnhRrfflrfi: GRnRrRhRArrRnhRnrR 


Browse... 


a 


r. Select the Use Data Type Variables option, then click on the More (LU) button for the Inputs 
field. 


== Properties 


Problems 


Details 


Compensation 


Join Behavior 


Correlation 


Expiration 


Server 


Servers 


Console 


v Generate Acceptance 

GenerateAcceptance 
GenerateAcceptance 


Partner: 

Interface: 

Operation: 


generateAcceptance 


(gj)j 


se Data Type Variables 


Human Task 


Name 

Variable jt 

Event Monitor 

0] Input(s) 

inputl 

(none) 

... 


ID Output(s) 

output 1 

(none) 


Browse, 


s. 


From the Select Variable for inputl window, ensure that CustomerApplicationVariable is 

selected, then click on OK. 
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t. Perform the same steps to also specify CustomerApplicationVariable for the Output. 


0 Use Data Type Variables 



Name 

Variable 


Dl Input(s) 

input 1 

CustomerApplicationVariable 

.., 

[0 Output(s) 

outputl^ 

CustomerApplicationVariable 

1 ■ ■ i 


These configuration changes specify that the CustomerApplication business object will be used 
for both the input and output of the GenerateAcceptance activity. 


u. 

v. 


Click on the SimpleAccountVerificationReply activity. 
From the Properties view, select the Join tab. 


O SimpleAccountVerificationReply 


== Properties X 


Problems 

Servers 

Console 





Description 


Details 




Join Behavior 


:> 


SimpleAccountVerificationReply 

n 


Expression language: 


ava 


Correlation 


Server 


Expression Type: 0 Visual © Java 


return ( (get Links tat us ( "PricingandApprovalOutput 
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w. 


Select the Visual option for the Expression Type. 



x. From the Question window, click on Yes. 



The Visual Snippet Editor appears which will allow you to implement logic or expressions without 
having to know Java programming. 


Simple AccountVerificationReply 


Expression language: Java 

Expression Type: © Visual O Java 



The default expression in the Visual Snippet Editor simply indicates that a boolean value of true 
will be returned to the caller of the SimpleAccountVerification process. At this point, no changes 
are necessary. 

y. Press Ctrl-s to save the changes to the BPEL process. 

z. Close the SimpleAccountVerification BPEL process editor. 

Notice that as you were developing the BPEL process, the actual implementation for the tasks or 
activities in the process were never specified. You only associated the activities to partners or 
references to external implementations. This provides the loose-coupling characteristic needed for 
more effective modularization. The actual implementations are defined externally using the 
Assembly Diagram editor. This approach also provides a level of abstraction to components such 
as the BPEL process for greater IT flexibility. 


3. Add the implementation for the new Generate Acceptance task 
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From the Assembly Diagram editor, right-click on the SimpleAccountVerification component. 
From the popup menu, select Synchronize Interfaces and References -> from Implementation 

I | 


Simple AccountVerif ication_0266109845 





n 


from Implementation 
toMpIemencanon 


Undo Add Implementation 

tj* Redo 


Add 

Change Type... 

Convert to Import 

Generate Export... 
Regenerate Implementation 
Select Implementation 

Op* 




► 

► 


Synchronize Interfaces and References... 


\ 2 , 




a Copy 


This will remove the red ‘x’ mark (°) on the SimpleAccountVerification component, and will also 
add an additional reference point to the right of the component for the new GenerateAcceptance 
activity. The next step is to link that new reference point to another simple Java implementation. 




1..1 

© t 5impleAccountVerification_0266109845 M 



b. From the palette on the left, click the top component to display a sub-palette. Select the Java 
component. 



c. Click on an empty space in the canvas to drop the Java component. 

d. Single-click on the new Java component to edit the name. Change the name to 

GenerateAcceptance. 

Hint: You can also right-click on the new Java component, and from the popup menu, select 

Rename. 
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I * Assembly Diagram: bimpleAccouritVerification 


a 




<& 


% 



*- r ' j GenerateAcceptance | 





Simple Account VeriFication_0266109845 


-fi 


Simple 


e. From the palette, click on the Wire button. 

f. Click on the new GenerateAcceptance reference point on the SimpleAccountVerification 

process component. This will start a connection or wiring. 



g. Click on the GenerateAcceptance Java component. This will complete the new connection. 

h. From the Add Wire window, click on OK. 



i. From the palette, click on the Selection Tool button. ^ 

j. Double-click on the GenerateAcceptance Java component. 

k. From the Open confirmation window, click on Yes. 
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From the Generate Implementation window, accept the default selection, then click on OK. 


4* Generate Implementation. 


□ X 


Select the package where the Java implementation will be generated: 


(default package) 


businessitems 
businessserviceobjects 
ffl processes 

processes. simpleaccount verification 

The Java editor appears for the implementation of the GenerateAcceptance component. 


m. Scroll down to the bottom of the Java code. Select the highlighted text below and delete. 


public DataObject generateAcceptance[DataObject input1) { 



//TODO Needs 

to be implemented. 

return null; 

■ ■ ■ M m „ 


} .... p e | e t e Highlighted 


n. Type credrep in the line of code as shown below. Press Ctrl-Spacebar. 


V 


public DataObject 



geneuateAcceptance(DataObject 

Press Ctrl-Spacebar 


input1) 


{ 


The Ctrl-Spacebar key combination activates a special feature called Code-Assist. This will add 
the required code snippet for you. 
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pub lic DataQbject generateAcceptance(DataQbject inputl) { 

/ * * 

* CODE STUB 

* P lace ho 1 s:ler for production code later 

* Code only for initial development and testing 

V 

System.out.printIn (">>>>>>>>>>>>>>>>>>>>>>>>>>>"); 

System.out.printIn( ">>>>> Request is approved!."); 
System.out.printIn( ">>>>> Pricing Plan has been set to " 
+ input1.getString( "pricing" )); 

System.out.printIn (">>>>>>>>>>>>>>>>>>>>>>>>>>>"); 

V return inputl; 

> ^- 


This code logic will display the Pricing Plan output from the Pricing and Approval human task. 
The Pricing and Approval human task will be implemented in the next steps. 

o. Press Ctrl-s to save the Java code, then close the Java editor. 

2. Convert the Pricing and Approval Java component to a Human Task 

a. From the SimpleAccountVerification assembly diagram editor, right-click on an empty space in 
the canvas. From the popup menu, select Layout Contents. 

_ ^L.UUIII 'JUL LLIH— 

Arrange Contents Au tomatically 
^ Layout Contents' ^ 

Test Module 


Show in Properties 


This will rearrange the components for a better layout. 

b. Press Ctrl-s to save the assembly diagram. 

c. If a progress indicator appears at the lower-right part of the main window, wait until it disappears 
indicating that the automatic build step is complete. 

Building workspace: 

d. From the Assembly Diagram editor, right-click on the PricingandApproval component. 
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e. From the popup menu, select Change Type -> Human Task. 



Pricingand Approval l 351 068^ 



■Vi SJ ^PnPK*hprwlinP 014^741711^7 


Undo Layout Contents 

Redo 


Add 


’- r ' Component (No Implementation) 
gf) Human Task 
Java 
Process 
Rule Group 
State Machine 


Change Type... 




Convert to Import 

Generate Export... ► 

Regenerate Implementation 
Select Implementation 
Open 

Synchronize Interfaces and References... ► 


f. Double-click on the PricingandApproval component, which is now a Human Task. 


-4 a 


Pricingand Appro val_l 3510682 


g. From the Open confirmation window, click on Yes. 



m 


f\ The selected component is not yet implemented, Would you like to implement 
• J the component now? 




h. From the Generate Implementation window, ensure that the SimpleAccountVerification folder 
is selected, then click on OK. 


4* £e lie rate Jm olerne niatie n 


Select th e fold er wher e the Hum an Task implementation will be generated: 




From the Human Task Component Handler window, change the name to 

PricingandApprovaIHumanTask, then click on OK. 


Simple Service Oriented Architecture Lab 


Page 105 of 171 

























































© Copyright IBM Corporation 2007. All rights reserved 



The Human Task editor will appear. 


* Assembly Diagram: SimpleAccount Verification 


PricingandApprovalHumanTask X 


▼Human task 


Detailed properties for a participating human task 
f e§ PricingandApprovalHumanTask 


^Receiver settings v 

, , Staff settings 

Potential Instance Creator 
Potential Owner 


j. Close the Human Task editor. At this point, we do not need to make any changes to the Human 
Task configuration. 

k. Focus should return to the Assembly Diagram editor. Press Ctrl-s to save your work. 


3. Generate a Web User Interface for the Human Task 


a. From the Business Integration tree view, right-click on SimpleAccountVerification. From the 
popup menu, select Generate User Interfaces. 
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b. From the User Interface Wizard for Human Tasks window, click on Next. 



c. From the next User Interface Wizard for Human Tasks window, specify the following, then click 
on Finish. 

Name of dynamic web project: HumanTask 

Company logo: C:/PoTFiles/JKLogo.jpg (Use the Browse button) 

Style selection: Cool Blue Style 
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4* JJserJ nte rfece JMimr dJarJJ liman. Tasks 


JSF client configuration 

Specify destination project, company logo, client location and style for your client. 



Name of dymamic web projec 
Company logo: 


<Jh 

<! 


HumanTask 




: /PoTFiles/JKLogo. jpg 





Browse... 


Client location 

(* Generated client and related processes / tasks reside on the same server.(Local client view) 
Generated client and related processes / tasks reside on different servers.(Remote client view) 
Provider URL: |iop://REMOTE_SERVERJP:BOOTSTRAP_PORT 



This will generate a standard web page which can be accessed using a web browser. The web 
page and all its related artifacts will be packaged into its own J2EE project so that it can be 
deployed as a separate web application. 

Let's pretend to work for a company called JK Enterprises. This is why we are using the graphic 
image file JKLogo.jpg for the Company logo. 


JK Enterprises Office Supplies Online 


From the Client generation completed information window, click on OK. 
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r 

Client generation comp 



4 ) 

The JSF client has been generated to a Web Project called "HumanTask". 


To deploy your client on the server, proceed as follows: 

1. In the server view, select "Add and Remove Projects" in the context menu to add 

your client proji 


2. Open a browser with the following URL: http://localhost:9080/HumanTask 

For more help., please select Help > Help Contents > WebSphere Integration Developer -> Assigning 


Deploying a generated client to a test environment 

OK 



Take note of the URL mentioned in the information window (http://localhost:9080/HumanTask) 
which will access the Human Task web page. In this lab environment, the port number 9080 is 
actually 9083. The correct URL is http://localhost:9083/HumanTask . 


. 4. Retest the SimpleAccountVerification process 

a. Switch to the Servers view. 


b. Right-click on the WebSphere Process Server v6.0 test server. From the popup menu, select 

Add and remove projects. 


• + i 





Properties 


Problems 


fl 


V servers X 


Con: 


Server 


WebSphere Process Server v6.0 


Monitoring 


Add and remove projects". 

Run universal test client 
Restart universal test client 
Run administrative console 

Reconnect debug process 

Create tables and data sources 

Import server configuration from server 
Export server configuration to server 

Launch 


•jame 


c. From the Add and Remove Projects window, click on Add All. 
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Available projects: 


LabCreditReport5ervice 


„ n 

0 □ 

+ p HumanTaskEAR 
+ g SimpleAccountVerificationA 


C 


Configured projects: 


Add > 


< Remove 


Add All >> 



Take note of the new project HumanTaskEAR. This contains the generated Human Task web 
interface. 

d. Click on Finish. 

e. A progress indicator will appear in the lower-right corner of the WebSphere Integration Developer 
window. Wait for this indicator to disappear before proceeding to the next step. This will take a 
few minutes. 


Add and Remove Projects 



f. Focus will automatically switch to the Console view. Verify that a message appears in the 
Console view indicating that the SimpleAccountVerificationApp process has started. Scroll 
right as needed. 


Lon sole X 


.0 [WebSphere v6.0 Server] WebSphere Process Server v6.0 (WebSphere v6.0) 

com.ibm.us.al.bootstrap.UASBootstrap appStart(DeployedApplication) CU 
SC A_S TARTING_AP P_MOD UL E 
SCA STARTED APP MODULE 


USVP02 071 
WSVR003 71 
J2CA0306I 


Preparing to start EJB jar: SimpleAccountVerificationEJB 
Starting EJB jar: SimpleAccountVerificationEJB.jar 
A^^ica^io^^Sini^eAccountVe^if^icat^onA^SS^iiri^eAccountVe 
USVP022 ll^App lieation started: SimpleAccountVerificationApp Q 


g. Switch to the Servers view and right-click on WebSphere Process Server v6.0. From the popup 

menu, select Launch->Business Process Choreographer Explorer. 
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h. Click on the My Process Templates link to display a list of processes which can be started. 


1 Assembly Diagram: SimpleAccountVerification 


fv Business Process choreographer Explorer 



Help 


Process Templates 
~ P ro ce s s" Te m p I ate s 


1 


My Tasks 


Place a checkmark beside the SimpleAccountVerification process template, then click on Start 
Instance. 



Available Actions 


Valid From 0 
2/10/07 8:12:0 


r Process Template Name 0 

SimpIeAccountVerification 0288109845 

Items found: 1 Items selected: 1 



j- 

k. 


From the default input page, click on the Expand ( 


+ 


) button. 


For the customerlD field, type 111, accept the defaults for the other fields, then click on Submit. 

Any Customer ID value other than “123” is required so that the request will be approved and follow 
the execution path which includes the Pricing And Approval business activity. 


The Credit Score will be displayed, but the execution of the process will pause. 


o ********************* 

0 * Call Web Service * 
o ********************* 

0 »»> Credit Score = 501 


The process has actually reached the Pricing and Approval human task activity in the execution 
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flow. It is waiting for a response from a ‘human’. In the next few steps, you will assume the role of 
a Loan Officer or Credit Manager, and interact with the business process. 

However, let’s first verify that the process is actually waiting on the Human Task activity. 

5. View the Process State 

a. From the Business Process Choreographer Explorer, click on the Started By Me link. 


-] Process Instances 

| 

Started By Me 


Administered By Me 


Critical Processes 


Terminated Processes 


Failed Compensations 



b. In the Available Actions section, place a checkmark beside the process instance, then click on 

View Process State. 




c. Click on Accept. 
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Snftwar&l.icensa Agreement. 


X_ 


Please read the following License Agreement. Press the PAGE DOWN key to see 
the rest of the agreement. 


ADOBE SYSTEMS INCORPORATED a 

FOR ADOBE(r]ACR0BAT(r) READER(r|. ADOBE ACROBAT EBOOK READER(tm) AND 
ADOBE SVG VIEWER SOFTWARE. 

End User License Agreement 

Please return any accompanying registration form to receive registration benefits. 

NOTICE TO USER: PLEASE READ THIS CONTRACT CAREFULLY. BY USING ALL 
OR ANY PORTION OF THE SOFTWARE YOU ACCEPT ALL THE TERMS AND 
CONDITIONS OF THIS AGREEMENT, INCLUDING. IN PARTICULAR THE 
LIMITATIONS ON: USE CONTAINED IN SECTION 2: TRANSFERABILITY IN 
SECTION 4: WARRANTY IN SECTION SAND 7;AND LIABILITY IN SECTION 8. YOU 
AGREE THAT THIS AGREEMENT IS ENFORCEABLE LIKE ANY WRITTEN 
NEGOTIATED AGREEMENT SIGNED BY YOU. IF YOU DO NOT AGREE. DO NOT 
USE THIS SOFTWARE. IF YOU ACQUIRED THE SOFTWARE ON TANGIBLE MEDIA 

Do you accept all the terms of the preceding License Agreement? If you choose Decline., 
the Adobe SVG Viewer will be disabled. T o run the Adobe SVG Viewer, you must accept this 
agreement. 


C 


Accept 


D 


Decline 


This will accept the license agreement to use the Adobe SVG Viewer. A graphic image of the 
current state of the SimpleAccountVerification process will be displayed in the SVG format. 


■ 



d. Click on the Zoom In button above the SVG viewer two times. 



e. Click on the Left arrow button two times. 



0 
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This should center the diagram in the SVG viewer. Continue to adjust and resize the image as 
necessary. 

f. Move the cursor on top of the Credit Risk Assessment task until a popup status box appears. 



This shows that the Credit Risk Assessment task was invoked and completed. 

g. Move the cursor on top of the Generate Decline task. Note that the status box indicates that this 
activity was skipped because the request is going to be approved. 

h. Move the cursor on top of the Pricing and Approval task. 



Note that the status is “Running”, indicating that the process is currently waiting for this activity to 
finish. Since this is a Human Task, the process is waiting for a ‘human’ to respond. This will be 
done using the generated web interface in the next few steps. 

6. Use the Human Task Web User Interface 
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a. Start the Internet Explorer. 

b. Go to http://localhost:9083/HumanTask . 

c. From the My ToDo’s section, click on the Open link. 


Canada [change] | Eng 

JK Enterprises Office Supplies Online 


I > Ooen 

d. From the Open Tasks section, click on the PricingandApproval task. 



i> HOME 



Business User Client 

My ToDo's 


As previously mentioned, you were not required to log in with a UserlD and password because 
security is currently disabled. This will typically not be the case in production environments. 
Based on the security profile or credentials of the user, the list should only display tasks which 
have been assigned to the user. 
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e. Click on the Claim button. 


My ToDo's > Open > PridngandApproval_13510682 


Select 'Claim' if this is the task you want to work on. 


Input Data 


applicationID: 

applicationDate: Feb 16, 2007 

pricing: 

requestedLimit: 0.0 

customer: 


customerlD: 111 

companyName: 
customerAddress: 
customerCity: 
customerStatePro vince: 
customerCountry: 
customerPostalCode: 
customerTaxID: 
credits co re: 501 

creditReportRequired: false 
applicationDecision: false 

creditRiskAssessment: LOW 



f. In the Output Data section, specify Plan ABC in the pricing field, then click on Complete. 
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Output Data 


application^: 

applicationDate: 

pricing: 

requestedLimit: 

customer: 



customerlD: 

companyName: 

customerAddress: 

customerCity: 

customerStatePro vince: 

customerCountry: 

customerPostalCode: 

customerTaxID: 


creditScore: 

creditReportRequired: □ 
applicationDecision: □ 

creditRiskAssessment: 



You can actually specify any text you want in the pricing field. This will just be displayed as a 
message in the Console view. When the Complete button is pressed, the Output Data specified 
above will be passed back to the SimpleAccountVerification process, and the process will 
resume its execution. 

g. Switch back to the WebSphere Integration Developer. 

h. Switch to the Console view and check for the latest messages. 


o 

O >>>>> Request is approved!. 

0 »»> Pricing Plan has been set to Plan ABC 
0 
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The new messages will show the pricing plan specified in the Pricing and Approval human task. 


.7. Cleanup 

a. Close the Business Process Choreography Explorer. 

b. Close the Internet Explorer. 

c. Switch to the Servers view. 


d. Right-click on the WebSphere Process Server v6.0 test server. From the popup menu, select 

Add and remove projects. 

e. From the Add and Remove Projects window, click on Remove All. 

f. Click on Finish. 


g. If a progress indicator appears, wait until it is complete. UnPubllsh SimpleAcco, " A P p: ^ 50% - 

h. From the Servers view, right-click again on the WebSphere Process Server v6.0 test server. 
From the popup menu, select Restart -> Start. 


r 


Properties 


Problems 


-V Servers X 


Server 


M WebSphere Process Server v6.0 


^ Debug 

©Start 
— I a- 




(| Restart 


Stop 

Disconnect 
Publish 


Host name 


Debug 



Profile 









Please wait for the next lecture before proceeding with the lab. 


Simple Service Oriented Architecture Lab 


Page 118 of 171 







































© Copyright IBM Corporation 2007. All rights reserved 


Part 8: Connectivity Flexibility with an ESB 



SOA improves businesses’ ability to meet market needs 

By providing a more flexible infrastructure 


With SOA, IT is flexible 
and responsive to 
business needs 



Imagine if your business 
could do that. 


Without SOA, IT can’t easily keep up 
with fast changing requirements of 
customers, partners, and competition. 



Do you need superhuman strength to 
make changes to your business? 


If innovation is defined as the process of making changes to do 
something new. which method would be best for innovation? 



The WebSphere Enterprise Service Bus and Mediations provide flexibility at the service 
connectivity tier. Currently, the SimpleAccountVerification process invokes a specific 
and fixed web service for the Credit Report activity. However, the process now needs to 
invoke either a Basic Credit Report service or a Premium Credit Report service 
depending on specific criteria, such as the customer’s company name. The use of 
mediation modules will allow the connectivity and routing logic to be extracted from the 
main process. This is loose-coupling taken to another level, or the connectivity level. It is 
another layer of abstraction where the main process does not need to know which service 
endpoint will be invoked to perform the requested task. The process simply needs to 
invoke a generic and abstract service, and the WebSphere Enterprise Service Bus can 
handle the routing, transformation, and mediation of the request to the actual service 
endpoints. 
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Basic Credit 
Report Service 


Premium Credit 
Report Service 




j 

) 


1. Import New Credit Report Web Services 


a. From the main menu, select File -> Import. 

The first step is to import a Library Module containing common or shared Service Interface 
definitions, and business object definitions. 

b. From the Import window, select Project Interchange, then click on Next. 


-t 1 " import 

a 

Select 



Import a project and its dependent projects from a Zip file. 

[L^JO 


| Select an import source: | 




<tf 


Profiling filter 


Project Interchange 


kak rile 




c. From the Import Project Interchange Contents window, click on the top Browse button and then 
select C:\PoTFiles\CreditReportServiceLib_Pl.zip for the From zip file field. 



d. Place a checkmark beside CreditReportServiceLib, then click on Finish. 
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This will import the CreditReportServiceLib Module into the WebSphere Integration Developer. 
This is a Library Module which contains the Interface (WSDL) files for the BasicCreditReport and 
PremiumCreditReport web services. A Library Module is the way standard or common interface 
definitions and object definitions can be shared across different modules. The actual code for the 
BasicCreditReport and PremiumCreditReport web services are stored in Enterprise Archive 
(EAR) files, and these will be imported next. 

e. From the main menu, select File -> Import. 

f. From the Import window, select EAR file, then click on Next. 


Select an import source: 


r/Chec ko ut Pro jects from CVS 

9 




4 EJB JAR. file 


g. From the Import window, click on the top Browse button and then select 

C:\PoTFiles\BasicCreditReportWebServiceEAR.ear for the EAR file field. 



Simple Service Oriented Architecture Lab 


Page 121 of 171 













































© Copyright IBM Corporation 2007. All rights reserved 


h. Click on Finish. 


W Import EAR Project 

r Overwrite existing resources without warning. 
I Delete project on overwrite 


Target server: [WebSphere Process Server v6.0 




New... 



Add support for annotated Java classes 



i. From the Confirm Perspective Switch window, place a checkmark on the Remember my 
decision option, then click on No. 



j. From the main menu, select File -> Import. 

k. From the Import window, select EAR file, then click on Next. 


Select an import source: 



v Checkout Protects from CVS 


EAR file 



4 EJB JAR. file 


I. From the Import window, click on the top Browse button and then select 

C:\PoTFiles\PremiumCreditReportWebServiceEAR.ear for the EAR file field. 
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Import 


Enterprise Application Import 

Import an Enterprise Application project based on selected resources. 



EAR file: C:\PoTFiles\PremiumCreditReportWeb5erviceEAR.ear 

~T 


Browse... 

EAR project: PremiumCreditReport'WebServiceEAR 



New... 


m. Click on Finish. 


17 Import EAR Project 

r Overwrite existing resources without warning, 
r Delete project on overwrite 

Target server: WebSphere Process Server v6.0 -q Mew... 


Add support for annotated Java classes 



The two new web services for BasicCreditReport and PremiumCreditReport have now been 
imported into the workspace. The next steps will be to use the two new web services in a 
Mediation Module. 


. 2. Start Publishing Projects to the Test Server 

a. Switch to the Servers view. Right-click on WebSphere Process Server v6.0. From the popup 
menu, select Add and Remove Projects. 

b. From the Add and Remove Projects window, add the following projects one by one: 

BasicCreditReportWebServiceEAR 

PremiumCreditReportWebServiceEAR 

HumanTaskEAR 

LabCreditReportService 


Move projects to the right to configure them on the server 
Available projects: 


+ 


□ 5impleAccountVerification0 


Add > 


K D, 


Configured projects: 


l±l 

EE 

FE 


D BasicCreditReportWeb5er\ 
PremiumCreditReportWeb^ 
HumanTaskEAR 
X o^LabCreditReportService ^ 
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c. Click on Finish. 

You will not need to modify these projects so let’s start deploying these into the test server. This 
will save you time later on when you’ll need to deploy and test the entire business process. 

3. Create a Mediation Module 

a. From the Business Integration tree view, right-click on the SimpleAccountVerification module. 
From the popup menu, selection New -> Mediation Module. 


New ► 

f j Project... 

Open Assembly Diagram 


Open Deployment Editor Q 

Mediation Module ^ 

Open Dependencies 

Module 

5how Files 

Taf Library 


b. From the New Mediation Module window, specify CreditReportServiceRouter for the Module 
Name. For the Target Runtime, select WebSphere Process Server v6.0, then click on Next. 



c. From the New Mediation Module window, place a checkmark beside CreditReportServiceLib, 
then click on Finish. 
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New Mediation Module 


Select Required Libraries 

Select libraries containing re-usable resources sui 


Libraries: 

editReportServiceLib 



The new Mediation Module has been created. 

d. From the Business Integration tree view, double-click on CreditReportServiceRouter -> 
Assembly Diagram. 


Business Integration X 



± kgj CreditReportServiceLib 

CreditReportServiceRouter 


Assembly Diagram 




Dependencies 
Eu Mediation Logic 

e. From the tree view, drag and drop CreditReportServiceLib -> Interfaces -> CreditReport to an 
empty space in the Assembly Diagram: CreditReportServiceRouter editor. 


h~~ Business Integration £3 


a & □ % 

B-lSJ CreditReportServiceLib 


Dependencies 
+ © Data Types 

- Interfaces _ _ 

I; CreditReport 


Assembly Diagram: Simple AccountVerification 




I 


Q 




lapping 
F Events 


El 




% 





f. From the Component Creation window, select Export with no Binding, then click on OK. 


ComDQiieiitXreaijoji. 


Select the type to create: 


1*1 


^Component with no Implementation Type 


Export with no Binding 


^Export with WeB Service"Binding 
Import with no Binding 


This will create a CreditReportExport component in the Assembly Diagram editor. Rearrange the 
components if necessary. 
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Assembly Diagram: SimpleAccountVerification 


"5 * Assembly Diagram: Lr e d i tRep 0 r t b erv 1 ceRouter X 


n 


s 

■—h 

& 


% 


0 i Credit RepurtExportl 


v 


13. Mediation 1 


g. From the tree view, drag and drop the BasicCreditReport web service to an empty space in the 

Assembly Diagram editor. 


Business Integration X 




a & e % 


- CreditReport5erviceLib 
^ Dependencies 

+ C Data Types 
1 Interfaces 

- Mapping 

Tr' Events Jj 

^ W eb Service Ports _ ^ 

CT .-y BasicCreditReport BasicCreditReportHt 

. PremiumCreditReport_PremiumCreditR.e 

- 1- ? CreditPeportServicePouter 


Assembly Diagram: SimpleAccountVerification 




El > 

c*> 

c t-, 


^ CreditPeportExportl 




h. From the Component Creation window, select Import with Web Service Binding, then click on 
OK. 


4* Com m ne nt Creation, 


Select the type to create: 



’ J ~ Component with no Implementation Type 
^Export with Web Service Binding 

T> 


Import with 'Web Service Binding 



This will create a CreditReportlmportl component in the Assembly Diagram. 

i. From the tree view, drag and drop the PremiumCreditReport web service to an empty space in 

the Assembly Diagram editor. 


Simple Service Oriented Architecture Lab 


Page 126 of 171 









































































© Copyright IBM Corporation 2007. All rights reserved 


Business Integration X 





- tgk CreditReportServiceLib 
2 Dependencies 
+ l- DataTypes 
- 1 Interfaces 

! .(J) CreditReport 

+ Mapping 
Y Events 

* Web Service Ports 

^ BasicCreditReport_BasicCreditReportHt _ 

r y PremiumCreditPeport_PremiumCreditPe 
CreUitPeportServicePouter 

i. ) Assembly Diagram 
2 Dependencies 


Assembly Diagram: SimpleAccountVerification 


rln Jt-O 



H 


0 
■—h 

C* 


A CreditPeportExportl ~ 


cv CreditPeportlmportl 


1 


_ 


j. From the Component Creation window, select Import with Web Service Binding, then click on 
OK. 


J* Component Creation 


X 


Select the type to create: 


’ J ~ Component with no Implementation Type 

Binding ... 


Import with Web Service Binding 



This will create a CreditReportlmport2 component in the Assembly Diagram. 

k. From the palette, click on the Wire icon to switch to connection mode. 

l. Connect the CreditReportExportl component to the Mediationl component. 



CreditReportExport 1 



m. From the Add Wire window, place a checkmark on the Always create without prompt option, 
then click on OK. 
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n. Connect Mediationl to CreditReportlmportl. 

o. Connect Mediationl to CreditReportlmport2. 

p. From the palette, click on the Selection Tool icon, 

q. Right-click on an empty space in the Assembly Diagram editor. From the popup menu, select 

Layout Contents. 


39 0 


07 CreditReportExportl 


Q Mediationl 



•cy CreditReportlmportl 


fy CreditReportImport2 



r. Right-click on CreditReportExportl . From the popup menu, select Rename, then rename the 
component to CreditReportServiceRouter. 

s. Rename CreditReportlmportl to BasicCreditReport. 

t. Rename CreditReportlmport2 to PremiumCreditReport. 


® 0 


- CreditReportServiceRouter 


E3 Mediationl 




BasicCreditReport 




PremiumCreditReport 



This Assembly Diagram now shows how requests for a Credit Report sent to this 
CreditReportServiceRouter module will be routed to either the BasicCreditReport service or the 
PremiumCreditReport service depending on the Company Name contained in the request. 

u. Right-click on CreditReportServiceRouter. From the popup menu, select Generate Binding -> 
SCA Binding. 



v. Press Ctrl-s to save the Mediation Module Assembly Diagram. 

All the components or building blocks have now been assembled for the 
CreditReportServiceRouter Module. The next step is to implement the Mediation Module. 


4. Implement the Mediation Module 

a. From the Assembly Diagram editor, double-click on the Mediationl component. 

Simple Service Oriented Architecture Lab 


Page 128 of 171 





























































































© Copyright IBM Corporation 2007. All rights reserved 


b. From the Open window, click on Yes. 



c. From the Generate Implementation window, accept the default folder selection and click on OK. 


■fcjEeneiate Implementation 


□ X 


Select the folder where the Mediation Flow implementation will be generated: 


CreditReportserviceRouter 


The Mediation Flow Editor for the Mediationl component will appear. 

d. Maximize the Mediation Flow Editor: Mediationl view if needed. 

e. From the Mediation Flow editor, move the cursor on top of the CreditReport Interface box to 
expose a yellow connector. 


(i) CreditReport 


^ InputCriterion 



f. Click on the circle part of the yellow connector, and then connect to the CreditReportPartner 
Reference box. 


smbly Diagram: SimpleAccou... 


* Assembly Diagram: CreditRepo.,. 


Mediation Flow Editor: Mediat 


ration connections © £3 ^ M 

a source operation., connect it to one or more target operations., and define the mediation flow, 


(i) CreditReport 


InputCriterion 




] CreditReportPartner 


^ InputCriterion 


] CreditReportPartner 1 


%' InputCriterion 
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This will create a connection between the CreditReport Interface to the CreditReportPartner 
Reference. 


(i) CreditReport 


] CreditReportPartner 



% InputCriterion ^ 


^ InputCriterion 

-- 


] CreditReportPartner 1 


^ InputCriterion 


The CreditReportPartner box represents the BasicCreditReport web service. This can also be 
renamed if needed for clarity. 

g. Expose the yellow connector again for the CreditReport Interface box. 


(i) CreditReport 


InputCriterion 


h. Connect the yellow connector to the CreditReportPartnerl Reference box. 



(i) CreditReport 
InputCriterion 


CreditReportPartner 


c 


^ InputCriterion 


CreditReportPartner 1 


^ ^ InputCriterion 


The CreditReportPartnerl box represents the PremiumCreditReport web service. 

The Request Flow Editor should appear at the bottom. If not, click on the connection to display the 

Request Flow Editor. 



] Input 


InputCriterion : CreditReport 



InputCriterion : Crec 

1 ——c 


i 


InputCriterion : Crec 


1 


■ 

i. 


From the palette, click on the Message Filter icon. 
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j. Drop the Message Filter into the Request Flow editor, and rename MessageFilterl to Service 
Router. 


] Input 


InputCriterion : CreditReport 



5erviceRouter 


9 





InputCriterion : CreditRepor.. 

Callout 


InputCriterion : CreditRepor.. 

Callout 


k. Move the mouse on top of the oi/fterminal for the InputCriterion : CreditReport Input node. 



Input 

InputCriterion : CreditReport 



This will expose the yellow connector. 


00 

T 

Input 


L 

InputCriterion : 


CreditReport Jr€> 


I. Connect the yellow connector to the in terminal of ServiceRouter. 


In put 

f 

InputCriterion : CreditReport 



ServiceRouter 



m. Right-click on ServiceRouter. From the popup menu, select Add Output Terminal. 

n. From the New Dynamic Terminal window, specify premium as the Terminal name, then click on 
OK. 
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^ewDvnamicJierjiiijiaL 



Create a new dynamic terminal 

Create a new dynamic terminal from a list of pre-defined terminal types. 


Terminal type 
Terminal name 


match 


C 


premium 


5 


Terminal description 


3 


On successful processing, if the input message content 
matches an ttPath patternListti]^ the input message is 
propagated unchanged to the output terminal with the name 


<3 


OK 




Cancel 


This will add a second terminal to ServiceRouter. 



ServiceRouter 


o 


5. Define the Routing Logic to the PremiumCreditReport Service 


a. If you have the Mediation Flow Editor currently maximized, double-click on the titlebar to restore it 


to its original size. 



:+: Mediation Flow Editor: Mediation 1 §0 


b. Click to select ServiceRouter. Switch to the Properties view and click on the Details tab. 


I i= Properties X 

Problems Servers Console 



Description 

Jp Message Filter : ServiceRouter 

Terminal 

^Details 

Distribution mode: First 

Promoted Properties 

Filters: 
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c. From the Details view, click on Add. 


Message Filter : ServiceRouter 

Distribution mode: First 

3 

Filters: 


| 

Pattern | 

Terminal name f 

Add... 




Edit,., 




Remove 
















♦ W 




£ ¥ 


d. From the Add/Edit window, click on Custom XPath. 


r 

4- Add/Edit I X I 


Add/Edit properties 



Specify the properties, 









Finish j 

Cancel 




In the next steps, you will define the routing logic for the premium terminal. In other words, you 
will specify the criteria for when the request should be sent to the PremiumCreditReport web 
service. 

e. From the XPath Expression Builder window, expand the body : InputCriterion schema to select 
the companyName field. 
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JtBatJiifxp nession Jiujldejii 


Build the XPath Expression 

Select the target from the Schema Viewer and optionally define a condition, 
or select Override to manually enter an XPath expression 


x_ 



Schema Viewer: 


+ 

+ 

- 


ServiceMessageObject : PARENT 


context : ContextType 
headers : HeadersType 
body : InputCriterion 
b-G InputCriterion : _InputCriterion_ 
Input : CustomerApplication 
applications : string 
applicationDate : date 


A 


+ 

0 

+ 

/A 

+ 

o 

+ 

u 

— 

mJk 

■|JP 


+ 

c 

" + 


customer : Customer 
customers : string 


companyName : string 

i -1 i it h I- n- >zi k n H iH k 1=1 - it ■ fPKinrl 




These are the attributes of the CustomerApplication business object which will be passed into 
this CreditReportServiceRouter Mediation Module. 

f. Click on the Location link. 


s-G 


customers : string 


companyName : string 


.-I irhnmoK Arlrl kal-l" * rhrinn 


V 


XPath Location: 

/bodv/InputCriterion/Input/customer/companvName 

Condition: 

\ Location \ } = : Value \ 

Full XPath Expres 

sion: 

I - Override 

/body/InputCriterion/Input/customer/companyName 


g. From the popup list, select self::node(): string. 


XPath Location: 

/body/InputCriterion/Input/customer/companyName 

Condition: 


= [Valmi 


+ ■ self ■ 'nodefl 1 strino 

Full XPath Express 

c 



Override 
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h. Click on the Value link. 


XPath Location: 

/body/InputCriterion/Input/customer/companyNarme 

Condition: 

self: inodeQl 




Full XPath Expression: 


i. Ignore the popup list and just type in “IBM” (with the quotation marks). 


S XPath Location: 

/body/InputCriterion/Input/customer/companyName 

Condition: 

self::node() 


"IBM" ) 


j. Verify that the Full XPath Expression displays the following, then click on OK. 

/body/lnputCriterion/lnput/customer/companyName[self::node()=”IBM”] 


+ customerlD : string 

+ companyName : string 

j. n it-lr^nriQK rlrlKot-r ■ fl-Kirin 


XPath Location: 

/body/InputCriterion/Input/customer/companyName 

Condition: 

self: :nodeQ 

= 

"IBM" 


Full XPath Expression: 



Override 


/body/InputCriterion/Input/customer/companyName[self::nodeO= M IBM n ] 


0 


Q 


OK 


D 


Cancel 


This will define the routing logic where any request with a companyName of “IBM” will be 
forwarded to the PremiumCreditReport web service. 

As you can see, XPath expressions are used heavily here. XPath, at a very high level, is the 
standard way of searching through XML-based documents. Specifically, the expression above 
involves searching through the CustomerApplication object, which is really defined internally as an 
XML Schema Definition (XSD) file. 
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k. From the Add/Edit window, click on Finish. 



I. From the Request Flow editor, connect the ServiceRouter out terminal (topmost) to the topmost 

InputCriterion : CreditReportPartner Callout node. 


CreditReport 



ServiceRouter 





InputCriterion : CreditRepor... 


Callout 




q InputCriterion : CreditRepor 


Callout 


k> 


m. Connect the ServiceRouter premium terminal (middle) to the second InputCriterion : 
CreditReportPartnerl Callout node. 


CreditReport 






InputCriterion : CreditRepor.. 

Callout 



InputCriterion : CreditRepor... 


Callout 



The logic for the Request Flow is now complete. The next step is to complete the logic for the 

Response Flow. 

n. From the Flow editor, click on the Response: InputCriterion tab at the bottom. 
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This will switch to the Response Flow Editor. 

o. Connect the out terminals of both Callout Response nodes on the left side of the editor to the in 
terminal of the Input Response node on the right. 


Callout Response 


- - 1 

InputCriterion : CreditReport 

InputCriterion : CreditRepor... 

a 


Input Response [} 

f. Callout Response 

V 

1 




InputCriterion : CreditRepor... 



There is no special routing logic needed for the Response flow. Output will simply be passed back 
to the calling component. 

p. Press Ctrl-s to save the Mediation Flow. 

q. Close the Mediation Flow Editor. 

r. Focus should return to the Assembly Diagram editor for CreditReportServiceRouter. Press 
Ctrl-s to save the Assembly Diagram. 

s. Switch to the Problems view. Verify that no errors exist (messages with a red ‘x’ mark '). 
Warnings and informational messages are acceptable. 

t. Close the Assembly Diagram editor for CreditReportServiceRouter. 

6. Re-assemble the SimpleAccountVerification to use the 
CreditReportServiceRouter 
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a. From the Assembly Diagram editor for SimpleAccountVerification, delete the 

!◄- —— Delete 


CreditReportlmportl component. 




CreditReportlmport 1 


This will be replaced by the CreditReportServiceRouter Mediation Module. 

b. From the tree view, select CreditReportServiceRouter -> Assembly Diagram -> 

CreditReportServiceRouter. Drag and drop to an empty space in the Assembly Diagram editor. 


Business Integration X 


ffi & B % 


...L 


BasicCreditReport_BasicCreditReportHt a 
P remiumCreditReport_PremiunnCreditRe 
- ^ CreditReportServiceRouter 

Assembly Diagram ^ ^ 

^ BasicCreditReport - 


* Assembly Diagram: SimpleAccountVerification £2 

B 




PremiumCrediEReport 

Dependencies 
Eu Mediation Logic 
S Data Types 
1 Interfaces 


% 



0 4 SimpleAccountVerification_026i 


c. From the Component Creation window, select Import with SCA Binding, then click on OK. 


■K ComponentXreatjon. 


Select the type to create: 


D 


^ Import with no Binding 


Import with SCA Binding 




d. From the Manage Project Dependencies window, place a checkmark on the Remember my 
decision... option, then click on Cancel. 



There is no need to open the Module Dependency editor because there are no dependencies 
between the SimpleAccountVerification Module and the CreditReportServiceRouter Module. 
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e. Rename the new Importl component to CreditReportRouter. 


^Assembly Diagram: bsrnpleAccountVerfscation X 




□ 




■*’ SimpleAccountVerification Q266109845 



SimpleAccountVerificatic 


f. From the palette, click on the Wire icon to switch to connection mode. ^ 

g. Connect the CreditReportPartner reference point in the SimpleAccountVerification component 
to the CreditReportRouter component. 



h. From the palette, click on the Selection Tool icon. ^ 

i. Right-click on an empty space in the Assembly Diagram editor. From the popup menu, select 

Layout Contents. 

j. Press Ctrl-s to save the changes to the Assembly Diagram. 

k. Switch to the Problems view. Verify that no errors exist (messages with a red ‘x’ mark '). 
Warnings and informational messages are acceptable. 

7. Retest the SimpleAccountVerification Process 

a. Switch to the Servers view. 

b. Right-click on the WebSphere Process Server v6.0 test server. From the popup menu, select 

Add and remove projects. 
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1 + 1 

>- V 

!-! 



Monitoring 



C 

fj= Add and remove projects... 


■ \ 



Run universal test client 

Restart universal test client 


Properties 

Problems 

Com 

| f 

Server 

Run administrative console 

k 

|ii^WebSphere Process Server v6.0 

Reconnect debug process 





[ J Create tables and data sources 




Import server configuration from server 




Export server configuration to 

server 




Launch 

* 


iame 


c. From the Add and Remove Projects window, add the following: 

SimpleAccountVerificationApp 

CreditReportServiceRouterApp 


Move projects to the right to configure them on the server 
Available projects; 


SimpleAccountVerification 


+ Ip 

+ CreditReportServiceRoutei 



Configured projects: 



BasicCreditReportWebSer\ 

PremiumCreditReportWebC 

HumanTaskEAR 

LabCreditReport5ervice 


d. Click on Finish. 

e. A progress indicator will appear in the lower-right corner of the WebSphere Integration Developer 
window. Wait for this indicator to disappear before proceeding to the next step. 


Add and Remove Projects 


C iirjr 


f. When the progress indicator has disappeared, switch to the Servers view and right-click on 

WebSphere Process Server v6.0. From the popup menu, select Launch->Business Process 
Choreographer Explorer. 


5a Servers 


ss Server v6.0 


Import server configuration from server 
Export server configuration to server 


Launch 


WPS Failed Event Manager 

Relationship Manager 

Common Base Event Browser 

Business Process Choreographer Observer 

Business Process Choreographer Explorer 

Business Rules Manager 

WPS Samples Gallery 
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_g. Click on the My Process Templates link to display a list of processes which can be started. 


. ) Assembly Diagram: SirmpleAccountVerification 


ft Business Process choreographer Explorer 



Help 


-] Process Templates 

My Process Templates 




My Tasks 



h. Place a checkmark beside the SimpleAccountVerification process template, then click on Start 
Instance. 


Available Actions 


Start Instance Instances 


View Structure 


Refresh 




r Process Template Name 

SimpIeAccountVerification 0266109345 

Items found: 1 Items selected; 1 


Valid From 0 
2/10/07 S: 12 : 0 


-=: -=: 


This will start the SimpleAccountVerification business process, and display the default Input page. 

i. From the Input page, specify 123 for the customerlD and IBM for the companyName. Accept 
the defaults for the other fields, then click on Submit. I Submit I 


Input applicationID 


applicationDate 


pricing 


requestedLimit 


customer 


2/19/07 


0.0 


customerlD 


companyName 


cu sto m e rAd dress 



123 


IBM 



You can use a Customer ID other than 123, but this will follow the ‘approved’ execution flow and 
invoke the Pricing and Approval Human Task. This means you will need to claim and complete 
the generated work item using the web browser as shown in the Human Task section of this lab. 

The first time this process is executed, it will take a few minutes because of one-time initializations. 
Subsequent executions or invocations will be significantly faster. 

j. Verify that the Premium Credit Report Service was invoked. 
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0 

0 

0 


****************************************** 
* 


*0 


Call Premium Credit Report Service 
* * * ************ ******** -?rs^r?r^rfr * * * * 


> 


0 >>>>> Credit Score = 449 


0 ****************************************** 
0 >>>>> Request is denied!. 


Based on the routing logic in the ESB Mediation Module (CreditReportServiceRouter) this 
process is now using, specifying IBM for the companyName will invoke the Premium Credit 
Report web Service. 

k. Start the SimpleAccountVerification process again. 



Available Actions 


Valid From 0 
2/10/07 8:12:0 

<< 


This time, specify ACME, or any other company name, then click on Submit. 


r Process Template Name 0 

SimpIeAccountVerification 0288109845 

Items found: 1 Items selected: 1 



customer 


customerlD 
companyName 
cu sto m e rAd dress 



m. Verify that the Basic Credit Report Service was invoked. 


o 

o 

o 


* * * ********************************* ** * * 

Call Basic Credit Report Service 
**************************************** 



O >>>>> Credit Score = 449 


0 **************************************** 


O >>>>> Request is denied!. 


This shows that when a Credit Report is requested by the SimpleAccountVerification process, 
the request will dynamically be sent to either the Premium service or the Basic service depending 
on the company name. This type of flexibility is possible through the ESB capabilities built into the 
WebSphere Process Server. 


7. Cleanup 

a. When you’re done testing the business process, switch to the Servers view. 

b. Right-click on the WebSphere Process Server v6.0 test server. From the popup menu, select 

Add and remove projects. 
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L_... 

f 

Properties 

Problems .T: K t 

Add and remove projects... J 

i 

Server 

Run universal test client 

Hosl 

|i!^WebSphere Process Server v6.0 

Restart universal test client 

loca 



Run administrative console 




Reconnect debug process 



c. From the Add and Remove Projects window, remove only SimpleAccountVerificationApp . 

d. Click on Finish. 

e. A progress indicator will appear. Wait until it disappears. UnPutl|lih S'mpleAcco...App: (50%) 

I. Close the Business Process Choregrapher Explorer. 



i Assembly Diagram: SimpleAccountVerification 

Business Process Choreographer Explor^ £3 1 


Welcome: (English) 

Help 


Proceed to the next part. 


Simple Service Oriented Architecture Lab 


Page 143 of 171 





































© Copyright IBM Corporation 2007. All rights reserved 


Part 9: Dynamic Service Invocation 



SOA improves businesses’ ability to meet market needs 

By providing a more flexible infrastructure 


With SOA, IT is flexible 
and responsive to 
business needs 



Imagine if your business 
could do that. 


Without SOA, IT can’t easily keep up 
with fast changing requirements of 
customers, partners, and competition. 



Do you need superhuman strength to 
make changes to your business? 


If innovation is defined as the process of making changes to do 
something new. which method would be best for innovation? 



This is yet another level of IT flexibility involving dynamic service selection and invocation. 
This part of the lab will showcase how service endpoints can be selected based on policies 
and other business properties. These policies or properties can also be dynamically 
changed at runtime. For example, in the previous scenario, the ESB Mediation will route 
the request to either the BasicCreditReport web service or the PremiumCreditReport 
web service depending on the company name. Both web services are known by the ESB 
Mediation module. However, the requirement now involves routing the request to web 
services that are only known at runtime based on a specific policy. The number of web 
services involved is also only known at runtime. Specifically for the lab scenario, only web 
services that have a status of “available” can be invoked by the 
SimpleAccountVerification process. This requirement can be handled by using 
Mediations with the WebSphere Service Registry and Repository (WSRR). 
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Simple Account 
Verification 
Process 

v _/ 


Only use services that 
have a status of "available" 



Credit Report 
Service AAA 


Credit Report 
Service BBB 


Credit Report 
Service CCC 


(Add as needed) 










' \ 


i 

i 


i 


Other examples of business policies that can determine which services to invoke at 
runtime might be to always use the cheapest services for cost reductions, or to always use 
the fastest services for improved customer satisfaction. It can also be based on operating 
policies such as to always use the latest version, or to only use services with a 
“Production” classification. These policies or other custom properties can be defined in the 
WebSphere Service Registry and Repository (WSRR). 

As previously mentioned, this approach will also allow processes to support a flexible 
number of services. For example, if other Credit Report service providers need to 
participate in the SimpleAccountVerification process, then these new service providers 
just need to be added to WSRR, and the business process will recognize these new 
service providers at runtime. 


1. Add Custom Properties to the Web Services 

a. Start the Internet Explorer. 

b. From the Internet Explorer window, click on the WSRR Console link. You can also open the 
URL http://localhost:9083/ServiceReqistrv/ in the web browser. 

c. From the navigation bar, click on the Service Documents -> Load Document link. 


El Unified Service Metadata 
□ Service Documents 

Load Document 
ffl S D L D o c u m 1 nts 

XSD Documents 
XML Documents 
Policy Documents 

El SCA Modules 
m Service Metadata 




The two web services, BasicCreditReport and PremiumCreditReport, have to be loaded into 
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WSRR so these can be dynamically selected at runtime by the SimpleAccountVerification 
process. 

d. Using the Browse button, select the file C:\PoTFiles\CreditReportlnterface.wsdl, then click on 

OK. 



CreditReportlnterface.wsdl contains the common interface definition needed by both the 
BasicCreditReport web service and the PremiumCreditReport web service. 

e. Verify that the file was loaded successfully. 


El Messages 

GU- The WSDL document was uploaded successfully. 


f. From the navigation bar, click on the Service Documents -> Load Document link. 


□ Service Documents 



Load Document 


w S D L D o c u m e nts 


3 


g. Using the Browse button, select the file 

C:\PoTFiles\BasicCreditReport_BasicCreditReportHttpPort.wsdl, then click on OK. 

h. From the navigation bar, click on the Service Documents -> Load Document link. 


Q Service Documents 

Load Document 

:> 

W S D LDocume nts 
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i. Using the Browse button, select the file 

C:\PoTFiles\PremiumCreditReport_PremiumCreditReportHttpPort.wsdl, then click on OK. 

j. From the navigation bar, click on the Service Metadata -> WSDL -> Ports link. 


El Service Metadata 

E WSDL 

Messages 

Operations 

Port types 

Bindings 

Ports 

Services 



El XML Schema 


k. Verify that the following Ports exist. 



The two other CreditReport Services, BasicCreditReportServiceElectronicPort and 
PremiumCreditReportServiceElectronicPort, are used by the more advanced’ 
AccountVerification process. 
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I. Click on the BasicCreditReport_BasicCreditReportHttpPort link. 


□ 

B a s i cC re d itR e d o rtS e ru i ce E1 e ctro n i cP o rt 


http: // B a s i cC re d itl 

□ 

P re m i u m C re d itR e d o rtS e ruice E1e ctro n i cP o rt 


http://P re m i u m C r 

□ 

C1 e a n s e D ata I m d o rtl C1 e a n s e D ata Http P o rt 


http://P ro ce s s e s/" 


□ C 

BasicCreditReport BasicCreditReportHttpPort 1 


http: // P ro ce s s e s/ S 


□ 

PremiumCreditReport PremiumCreditReportHttpPort 


http://Processes/S 



m. Click on the Custom properties link. 


General Properties 

Name 

B a s i cC re d itR e p o rt_B a s i cC re d itR e p o rtHttp P c 
Description 


Additional Properties 


C 


Binding 
SOAP address 


Custom properties 


D 


Relationships 


n. Click on the New button.. 


Custom Properties 


Ports > Basic Credit Report Basic Credit Report Http Port !:= 

This is the collection of metadata properties defined for t 
BasicCreditReport_BasicCreditReportHttpPort and type po 

[+] Preferences 


^New 

Delete 

[[v 


S e 1 e ct 

Key 

Va 1 u e 

□ 

bsrURI 

WSRR--77S7c5SS.« 

□ 

name 

B a s i cC re d itR e p o rt_ 


o. For the Key field, specify Status. For the Value field, specify available. 


General Properties 




Cancel 
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These custom properties will be used at runtime to determine whether to use this specific service 
or not. In the lab scenario, only services with an “available” status will be used. 

p. From the navigation bar, click on the Service Metadata -> WSDL -> Ports link. 


El Service Metadata 

E WSDL 

Messages 

Operations 

Port types 

Bindings 

Ports 

Services 



El XML Schema 


q. Click on the PremiumCreditReport_PremiumCreditReportHttpPort link. 


□ 

B a s i cC re d itR e d o rtS e rvice E1 e ctro n i cP o rt 


http : // B a s i cC re d itR e p c 

□ 

P re m i u m C re d itR e d o rtS e r v i ce E1 e ctro n i cP o rt 


http ://PremiumCreditF 

□ 

C1 eanseDataIrmportl C1 eanseDataHttpPort 


http ://Processes/ToBe 

□ 

B a s i cC re d itR eport BasicCred itR e p o rtHttp P o rt 


http://Processes/Simp 

n C 

P re m i u m C re d itR eport PremiumCred itR e p o rtHttp P o rt 

;> 

http://P ro ce s s e s/S i m p 

i—i v 




r. Click on the Custom properties link. 


Additional Properties 


Binding 
SOAP address 




stem properties 




s. Click on the New button.. 


0 Preferences 




New 

J Delete 


Q 

t 


t. For the Key field, specify Status. For the Value field, specify offline. 
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General Properties 



By default, this service will not be selected at runtime because of its “offline” status. 


2. Create the Dynamic Credit Report Service Mediation Module 

a. Switch back to the WebSphere Integration Developer. 

b. From the tree view, right-click on the SimpleAccountVerification project. From the popup menu, 
select New -> Mediation Module. 

Hint: You can actually right-click on any top-level project. This will display the proper context for 
the popup menu so it becomes easier to select the New -> Mediation Module option. 

c. For the Module Name, specify DynamicCreditReportService. For the Target Runtime, select 
WebSphere Process Server v6.0, then click on Next. 
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d. Place a checkmark beside CreditReportServiceLib, then click on Finish. 


-t* New Mediation Module 


Select Required Libraries 

Select libraries containing re-usable resources : 


Libraries: 



reditReportServiceLib 


e. 


A progress indicator will appear, wait until it is complete. 


Building workspace: (27%) 


I 



Simple Service Oriented Architecture Lab 


Page 151 of 171 








































© Copyright IBM Corporation 2007. All rights reserved 


f. From the tree view, double-click on DynamicCreditReportService -> Assembly Diagram. 



g. Drag and drop CreditReportServiceLib -> Interfaces -> CreditReport into an empty space in the 
Assembly Diagram editor for DynamicCreditReportService. 


Business Integration X 


m & b % 


- tgj CreditReportServiceLib 

^ Dependencies 
+ L_ Data Types 
1 Interfaces 


Assembly Diagram: SimpleAccountVerification 

- B 




C T Lj) CreditR^iort 
+ Mapping 
? Events 


El 

Co » 

c i 3 


— 


r 


h. Select Export with no Binding, then click on OK. 


^ Component Creation 


Select the type to create: 



^ Component with no Implementation Type 


Export with no Binding 


Export with Web Serv^eTBinding 
=$ Import with no Binding 
■fX Import with Web Service Binding 


i. Drag and drop again CreditReportServiceLib -> Interfaces -> CreditReport into an empty space 
in the Assembly Diagram editor. 


r -v 

Business Integration X 

= □ 

Assembly Diagram: SimpleAccountVerification 


ffl & B % ▼ 

B 

E CreditReportServiceLib 

2 Dependencies 
+ © Data Types 
- 1 Interfaces 

Hi CreditReport 

A 

i i 

p -> 

+ Mapping 

?' Events 


1 r 
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j. This time, select Import with no Binding, then click on OK. 


£omDpnentXr.ealjoji. 


Select the type to create: 



’ J ~ Component with no Implementation Type 

i~j Export with no Binding 

■> y Export with Web Service Bind ing 



Import with no Binding 


Import with Web Service Binding 


k. From the palette, click on the Wire icon to switch to connection mode. 
J. Connect CreditReportExportl to Mediationl. 


m. Connect Mediationl to CreditReportlmportl. 


m. From the palette, click on the Selection Tool icon. 




n. Right-click on an empty space in the Assembly Diagram editor. From the popup menu, select 

Layout Contents. 


igram: Simple Account Verification 


* Assembly Diagram: DynamicLreditReportbervice X 



CreditReportExport 1 



* 


(i) 4> 


CreditReportlmport 1 


I 


o. Right-click on CreditReportExportl. From the popup menu, select Generate Binding -> SCA 
Binding. 

p. Press Ctrl-s to save the changes to the Assembly Diagram. 

n. Switch to the Problems view. Verify that no errors exist (messages with a red ‘x’ mark •'). 
Warnings and informational messages are acceptable. 

3. Implement the Mediation Flow 

a. From the Assembly Diagram editor, double-click on the Mediationl component. 
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b. Click on Yes. 


^ Opeji 



The selected component is not yet implemented, Would you like to implement 
. * J the component now? 


C 



Ves | 

) No 



c. Accept the default folder and click on OK. 



Gejier^teJniDlementfltioji. 


Select the folder where the Mediation Flow implementation will be generated: 


DynamicCreditReporthervice 


The Mediation Flow Editor appears, 
d. Connect CreditReport to CreditReportPartner. 

smbly Diagram: SimpleAcc... * Assembly Diagram: Dy namicC,., 


■^Mediation Flow Editor: Media, 


:ration connections 


g) ^ ^ X 


a source operation., connect it to one or more target operations., and define the mediation flow, 



_e. From the palette, click on the Message Filter icon (topmost) to open the sub-palette. Click on the 
Endpoint Lookup icon (bottom of the sub-palette). 
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If you cannot find the Endpoint Lookup icon, click on the small arrow shown below. 



f. Click on an empty space in the middle of the Flow editor. Rename the component to 

DynamicServiceRouter 


_riterion : CreditReport 


D- 


DynamicServiceRouter 




InputCriterion : CreditRepor 

Calloi 


g. With the DynamicServiceRouter component still selected, click on the Properties tab, then click 

on Details. 


!= Properties X 


Problems 


Description 


Terminal 



Servers 


Console 


Advanced 


Endpoint Lookup: DynamicServiceRouter 


Port Type (Interface) 
Name: 


CreditReport 


h. For the Name field, use the Browse button to select CreditReport. For the Registry Name field, 
specify wsrrstew. 
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Endpoint Lookup: DynamicServiceRouter 


Port Type (Interface) 
Name: 



CreditReport 






Browse, 


Namespace: http://Processes/5impleAccountVerification/CreditReportInterface 


Version: 


Registry Nar 
Match Policy: 


Return one matching endpoint 


The Registry Name “wsrrstew” is the alias of the WSRR server that was previously configured, 
i. Click on the Advanced tab. Scroll down to the User Properties section and click on Add. 



j. For the Name field, specify Status. For the Type field, select string. For the Value field, specify 

available. Click on Finish. 


Simple Service Oriented Architecture Lab 


Page 156 of 171 







































































































© Copyright IBM Corporation 2007. All rights reserved 



This will set up the Mediation Module to only select services from WSRR with a Status of 
“available”. 

k. In the Request Flow Editor, connect the CreditReport Input node to DynamicServiceRouter. 


0 Input 


InputCriterion : CreditReport 

L 



DynamicServiceRouter 



I. Connect DynamicServiceRouter to the CreditReportPartner Callout node. 


CreditReport 


DynamicServiceRouter 





InputCriterion : CreditRepor... 


Callout >> 


m. Click on the Response: InputCriterion tab to switch to the Response Flow editor. 


£ 


i —i 


Request: InputCriterio^^P Response: InputCriterion^ 


n. Connect the Callout Response node to the Input Response node. 



Callout Response 

InputCriterion : CreditReport 





m 
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o. Press Ctrl-s to save the Mediation Flow. 

p. Close the Mediation Flow Editor. 

q. Focus should return to the Assembly Diagram editor for DynamicCreditReportService. Press 
Ctrl-s to save the Assembly Diagram. 

r. Switch to the Problems view. Verify that no errors exist (messages with a red ‘x’ mark ). 
Warnings and informational messages are acceptable. 

s. Close the Assembly Diagram editor for DynamicCreditReportService. 


4. Re-assemble the SimpleAccountVerification Process to use the 
DynamicCreditReportService Module 

a. From the Assembly Diagram editor for SimpleAccountVerification, delete the 

-*® iJs CreditReportRouter ^ - Delete 

CreditReportRouter component. 

b. From the tree view, drag and drop DynamicCreditReportService -> Assembly Diagram -> 
CreditReportExportl to an empty space in the Assembly Diagram editor. 


Business Integration X 


a & b % 


F Events 

DynamicCreditReportBervice 

Assembly Diagram _ 

^ CreditReportExportl ^ 
Dependencies" 

L-i Mediation Logic 
1 — Data Types 
Interfaces 


■- ) * Assembly Diagram: BimpleAccountVerification l 

H 


(?jj > i 

l> > 


Mapping 

F F\/pnh^ 




A 


V 




^ Simple Account Verification 02f 


c. Select Import with SCA Binding, then click on OK. 


4* XomponentX rp^tioji. 


X 


Select the type to create: 


Jjlmport with no Binding 


Import with 5CA Binding 


z> 
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d. Place a checkmark on the Remember my decision... option, then click on Cancel. 



e. Rename Importl to DynamicCreditReportService. 

f. From the palette, click on the Wire icon to switch to connection mode. 

g. Connect the CreditReportPartner reference point in the SimpleAccountVerification component 
to the DynamicCreditReportService component. 

h. From the palette, click on the Selection Tool icon, 

i. Right-click on an empty space in the Assembly Diagram editor. From the popup menu, select 

Layout Contents. 

j. Press Ctrl-s to save the changes to the Assembly Diagram. 

k. Switch to the Problems view. Verify that no errors exist (messages with a red ‘x’ mark '). 
Warnings and informational messages are acceptable. 

5. . Retest the SimpleAccountVerification Process 

a. Switch to the Servers view. 

b. Right-click on the WebSphere Process Server v6.0 test server. From the popup menu, select 

Add and remove projects. 
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Monitoring 



► 


f- 

Properties 

Problems J 

V Servers X 

Com 


Server 


/ ji 

Ms WebSphere Process Server v6.0 


Run universal test client 
Restart universal test client 
Run administrative console 

Reconnect debug process 

[ J Create tables and data sources 

Import server configuration from server 
Export server configuration to server 



Launch 



c. From the Add and Remove Projects window, add the following: 

SimpleAccountVerificationApp 

DynamicCreditReportServiceApp 

d. Click on Finish. 

e. A progress indicator will appear in the lower-right corner of the WebSphere Integration Developer 
window. Wait for this indicator to disappear before proceeding to the next step. 


Add and Remove Projects 


f. When the progress indicator has disappeared, switch to the Servers view and right-click on 

WebSphere Process Server v6.0. From the popup menu, select Launch->Business Process 
Choreographer Explorer. 
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_g. Click on the My Process Templates link to display a list of processes which can be started. 


. ) Assembly Diagram: SirmpleAccountVerification 


ft Business Process choreographer Explorer 



Help 


-] Process Templates 

My Process Templates 





My Tasks 


h. Place a checkmark beside the SimpleAccountVerification process template, then click on Start 
Instance. 


Available Actions 



nstanc^^) Instan 


ces 


View Structure 


Refresh 





Valid From 0 


r Process Template Name 
1^ } SimpleAccountVerification 02SS109345 2/10/07 S:12:0 


Items found: 1 Items selected: 1 


-=: -=: 


This will start the SimpleAccountVerification business process, and display the default Input page. 

i. From the Input page, specify 123 for the customerlD. Accept the defaults for the other fields, 
then click on Submit. I Subnmt I 


applicationID 

applicationDate 

pricing 

requestedLimit 

customer 


2/21/07 


0.0 


customerlD 



company Name 


You no longer need to specify the Company Name. Determining whether to invoke the 
BasicCreditReport web service or the PremiumCreditReport web service will now be based on the 
Status property in WSRR. The BasicCreditReport web service should be invoked by default 
because its status is currently set to “available”. 
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I. Verify that the Basic Credit Report Service was invoked. 


G Call Basic Credit Report Service 

O >>>>> Credit Score = 449 


O 




O >>>>> Request is denied!. 


m. Switch to the Internet Explorer with the WSRR Console page. 

n. From the navigation bar, click on Service Metadata -> WSDL -> Ports. 

o. Click on the BasicCreditReport_BasicCreditReportHttpPort link. 


□ 

BasicCred itR e p o rtS e ruice E1e ctro n i cP o rt 


□ 

P re m i u m C re d itR e p o rtS e ru i ce E1 e ctro n i cP o rt 


□ 

C1 e a n s e D ata I m p o rtl C1 e a n s e D ata Http P o rt 


□ c 

BasicCreditReport BasicCreditReportHttpPort 


□ 

PremiumCreditReport P re miumC red itR eportHttp Port 



p. Click on the Custom properties link. Click on the Status link. 

q. Change the Status to offline, then click on OK. 


General Properties 


Key 


Status 


i 

^alue 

|offline j 



r. From the navigation bar, click on Service Metadata -> WSDL -> Ports. 

s. Click on the PremiumCreditReport_PremiumCreditReportHttpPort link. 


□ 

BasicCred itR e p o rtS e rv i ce E1 e ctro n i cP o rt 


□ 

P re m i u m C re d itR e p o rtS e ru i ce E1 e ctro n i cP o rt 


□ 

C1 e a n s e D ata I m p o rtl C1 e a n s e D ata Http P o rt 


□ 

BasicCred itR eport BasicCred itR e p o rtHttp P o rt 


□ c 

PremiumCreditReport PremiumCreditReportHttpPort 


t. Click on the Custom properties link. Click on the Status link. 
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u. Change the Status to available, then click on OK. 


General Properties 



Apply 


OK 


Reset 


Cancel 


v. Switch back to the WebSphere Integration Developer. 

w. Click on the My Process Templates link to display a list of processes which can be started. 



x. Place a checkmark beside the SimpleAccountVerification process template, then click on Start 
Instance. 



Available Actions 


Valid From 0 
2/10/07 8:12:0 


r Process Template Name 0 

SimpIeAccountVerification 0268109845 

Items found: 1 Items selected: 1 



This will start the SimpleAccountVerification business process, and display the default Input page. 


y. From the Input page, specify 123 for the customerlD. Accept the defaults for the other fields, 
then click on Submit. I Subnf1lt I 


Simple Service Oriented Architecture Lab 


Page 163 of 171 

















































© Copyright IBM Corporation 2007. All rights reserved 


applicationID 

applicationDate 

pricing 

requested Limit 
customer 


2/21/07 


0.0 


customerlD 



company Name 


Because we changed the status of the BasicCreditReport web service to “offline”, and the 
PremiumCreditReport web service to “available”, it should now invoke the 

PremiumCreditReport web service. 

z. Verify that the Basic Credit Report Service was invoked. 


0 * * * * * * 

0 Call Premium Credit Report Service T I** 

0 * * * * 

0 »»> Credit Score = AA9 
0 ****************************************** 
0 >>>>> Request is denied!. 


If the Basic Credit Report service was still invoked, try again. The cache timeout value of WSRR 
is set to 10 seconds, so the cache might not have been refreshed yet with your changes. 


.6. Cleanup 

a. When you’re finished testing, close the Business Process Choreography Explorer. 

b. Close the Internet Explorer. 

c. Switch to the Servers view. 

d. Right-click on the WebSphere Process Server v6.0 test server. From the popup menu, select 

Add and remove projects. 

e. From the Add and Remove Projects window, click on Remove All. 

f. Click on Finish. 


Congratulations! 


You have successfully completed all the labs. 
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Part 10: Conclusion 


WebSphere IBM 


SOA reduces business risk _ 

By providing quality, simplicity , and governance 


With SOA, simplicity and 
flexibility mitigates risk 


Reduced 

Risk 



Higher level of IF quality 


Incremental deployment 




u'- i ti Improved! payback times 



Without 8QA ? complexity and 
rigidity creates risk 


Which one would you put your money on? 



Hopefully these labs helped illustrate the significant benefits which can be achieved using 
IBM’s SOA Foundation and the WebSphere Process Integration software portfolio. 

• Business flexibility 

• Better business processes 

• Easier integration 

• Reuse of assets 

• Reduction of risk 
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Part 11: Appendix 


1. Loading Solutions for Parts of the Lab 

In case you encounter problems, or just wish to skip ahead to the solution of a specific part in the lab, 
then the completed projects are also available. The solutions can be imported as Project Interchange 
files located in the following directory: 

C:\PoTFiles\Solutions 

Below is a list of the solution files which can be found in the directory above. 


SimpleAccountVerificationSolution.mar 

Part 2 fully completed (WebSphere 
Business Modeler) 

SimpleAccountVerificationAIIJava_Pl.zip 

Part 4 fully completed 

SimpleAccountVerificationWebService_Pl.zip 

Part 5 fully completed 

SimpleAccountVerificationBusinessRules_Pl.zip 

Part 6 fully completed 

SimpleAccountVerificationHumanTask_Pl.zip 

Part 7 fully completed 

SimpleAccountVerificationESB_Pl.zip 

Part 8 fully completed 


Steps for loading a solution file into the WebSphere Integration Developer: 

1. Ask for assistance from the instructors or lab assistants if necessary. 

2. Remove all applications currently deployed to the test server. (Refer to the 
following screenshot) 
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J^ddajidJilemoveJ^miects 


Add and Remove Projects 

Modify the projects that are configured on the server 



Move projects to the right to configure them on the server 

Available projects: Configured projects: 


Add > 


< Remove 


Add All >> 


c 


<< Remove All 


D 


+ □ 5impleAccountVerificationA 






< Back Next > | 

Finish Cancel 




3. Delete all projects in the Business Integration view. 


t* Rysinpgp.Intporation^tiisi ops* Pmrpfts ChpreognapherE: 


File Edit Navigate Search Project Run 




Business Integration X 
CreditReportServiceLib 


CreditReportServiceRouter 
SimpleAccountVerification 



Window Help 

\ *z=> o - o * 
a & ¥ % ▼ 


Delete a]l 
projects 
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4 . Switch to the J2EE perspective. Delete all enterprise applications. 


-t* J2EE b BusinessJ?jJcessXhpreogrjaDheri«_ExDlorerjQiC:APjo 


File Edit Navigate Search Project Run Window Help 



iEj J ^ J ST 


& A 


r - Pro) 

ect Explorer X 


mp 

Enterprise App 

lications 


+ 


Application Client Projects 

Connector Projects 
C% EJB Projects 
ji Dynamic Web Projects 




+ LJ Other Projects 
+ C“, Web Services 
+ Lq Databases 
+ Lq Database Servers 


Delete all 
> Enterprise 
Applications 
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5. Switch back to the Business Integration perspective. 

6. Import the desired Project Interchange file. Refer to the solution file table 
described above. 
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7. If a progress indicator appears, wait until it is complete. 

Building workspace: (27%) (£" 

8. Perform a Project Clean-all. 


-t* B{Jgjj2£g£j£]teqj[£tio itjb 

Business Process Choreographer Explore 

File Edit Navigate Seartf 

p)_in Window Help 


U 

ii 


B - 


Business Integration X 


pen Project 
Close Project 


ehS! 


Q Build All 

Build Project 

Build Working Set 
CreditReportServiceRo C c|ean - 

>/ Build Automatically 


CreditReportServiceLib 


SimpleAccountVerificati 


Ctrl+B 




Clean will discard all build problems and built states. The projects 




be rebuilt 


from scratch. 


p Clean all projects 



Clean selected projects: <No projects selected> 


Browse... 


C 


OK 



Cancel 
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9. If a progress indicator appears, wait until it is complete. 


Building workspace: (27%) 



10. Ensure that there are no errors listed in the Problems view. If errors exist, delete 
the following files and perform another Project Clean-all (repeat step 8): 

SimpleAccountVerificationApp 

SimpleAccountVerificationEJB 

SimpleAccountVerificationWeb 

Do not delete SimpleAccountVerification. 


11. Start the test server if not yet started. 

12. Add all projects to the test server. 

13. Proceed to the section for testing the process in the appropriate part of the lab. 
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